List artwork price history
Lists an artwork's price changes, newest first. Appended automatically whenever the price changes.
Lists an artwork's price changes, newest first. Appended automatically whenever the price changes.
Authorization
bearerAuth artworks:read, artworks.financial:readA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artworks:read, artworks.financial:read
Path Parameters
The artwork id.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "data": [ { "id": "string", "artwork_id": "string", "price_cents": -9007199254740991, "currency": "string", "label": "string", "changed_by": "string", "created_at": "string" } ]}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}Set an artwork's price POST
Sets the artwork's list price on the record now — live for every reader, whoever sends it — and appends the price history. A pending draft that named the price is reconciled and the editor is told. Use this, not `PATCH`, to change a price.
Publish an artwork POST
Publishes the artwork's current draft: snapshots a new version and makes it the live, publicly readable state.