Update a list's catalogue content
Upserts the list's catalogue-PDF content. Only supplied fields change; null clears a field. Editor-only (enforced by RLS).
Upserts the list's catalogue-PDF content. Only supplied fields change; null clears a field. Editor-only (enforced by RLS).
Authorization
bearerAuth artworks:updateA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artworks:update
Path Parameters
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.
Upsert a list's catalogue content. Only supplied fields change; null clears a field.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "subtitle": "string", "starts_on": "string", "ends_on": "string", "venue": "string", "cover_image_path": "string", "foreword": "string", "colophon": "string", "updated_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}Get a list's catalogue content GET
Returns the list's catalogue-PDF content (subtitle, exhibition run, venue, cover override, markdown foreword and colophon). All fields are null until first saved.
Mint a signed cover-image upload URL POST
Returns a one-time signed target for uploading a list/room cover image directly to Storage. The server derives the gallery-scoped object key; the client uploads the bytes, then sets it via PATCH /gallery/lists/{listId} with `cover_image_path`. Requires a first-party session.