Remove an artwork from a show
Takes one artwork off the show's checklist. Before the show opens the entry is deleted; once it has opened the entry is closed and stays in the show's history (`removed` says which). The artwork itself is untouched.
Takes one artwork off the show's checklist. Before the show opens the entry is deleted; once it has opened the entry is closed and stays in the show's history (removed says which). The artwork itself is untouched.
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.
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", "removed": "deleted"}{ "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}Add artworks to a show POST
Adds artworks to the show's checklist, after its last position, in the order given. A work already on the show is left as it is and listed in `already_on_show`, so a repeated call changes nothing. The other fields apply to every work added. Needs `artworks:read` to check the works.
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.