Update an artwork on a show
Edits one artwork's entry on the show's checklist: its position, catalogue number, status, lender, note, or for an art fair its booth, wall and priority. Only the fields sent change. A booth must belong to this show, and a lender to this gallery.
Edits one artwork's entry on the show's checklist: its position, catalogue number, status, lender, note, or for an art fair its booth, wall and priority. Only the fields sent change. A booth must belong to this show, and a lender to this gallery.
Authorization
bearerAuth shows:updateA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: shows:update
Path Parameters
The show id.
The artwork id.
Query Parameters
Preview this operation without committing it. When true, the request is authenticated, scoped, and validated, but no side effect runs — no write, no idempotency claim, no audit event, no outbound delivery. The response is HTTP 200 with an X-Dry-Run: true header and a body of { "dry_run": true }, plus an effect object describing what the real call would change when this operation can resolve one.
Header Parameters
Optional. Send a unique key per logical operation to make retries safe: a retry with the same key replays the stored success for 14 days instead of re-running the write. Reusing a key with a different body returns 400.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
The fields of the work's entry on the show to change; the rest stay as they are.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "show_id": "string", "artwork_id": "string", "artwork_title": "string", "position": -9007199254740991, "catalogue_number": "string", "checklist_status": "proposed", "lender_party_id": "string", "note": "string", "booth_id": "string", "wall": "string", "priority": -9007199254740991, "valid_from": "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}List a show's artworks GET
Lists the artworks on the show's checklist, in checklist order (position, then when each joined), with each work's catalogue number, status, lender, note and, for an art fair, its booth, wall and priority.
Cancel a show POST
Cancels the show — live on the record now, whoever sends it. Its public page is withdrawn and it leaves the programme; the checklist and its works are untouched, which is why this is reversible with `POST …/reinstate`.