List artwork location history
Lists an artwork's location / movement history, newest first. Appended automatically whenever the artwork's location changes.
Lists an artwork's location / movement history, newest first. Appended automatically whenever the artwork's location changes.
Authorization
bearerAuth artworks:readA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artworks:read
Path Parameters
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", "location": "string", "reason": "string", "note": "string", "moved_by": "string", "created_at": "string" } ]}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}List artworks GET
Lists the gallery's artworks, newest first, with cursor pagination. Pass `draft=true` to get the editor's working copy (pending edits overlaid) instead of the published state. Pass `ids` (comma-separated, max 50) to fetch an explicit set.
Parse a caption into an artwork draft POST
Parses a pasted free-text caption into a structured artwork DRAFT for review — artist (resolved detect-existing-or-create against the gallery's roster), title, year, medium, dimensions, price/currency (incl. a range), and edition, with low-confidence fields flagged. This is read-shaped: it returns a suggestion and writes nothing. The model loop is server-only (the Anthropic key never reaches the browser); requires a first-party session.