Update the gallery's branding
Upserts the gallery's branding. Only supplied fields change; caption_fields is merged. Requires the gallery:write scope (key) or editor membership (user).
Upserts the gallery's branding. Only supplied fields change; caption_fields is merged. Requires the gallery:write scope (key) or editor membership (user).
Authorization
bearerAuth gallery:updateA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: gallery:update
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.
Fields to set on the gallery's branding (all optional).
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "logo_storage_path": "string", "logo_url": "string", "accent_color": "string", "background_color": "string", "text_color": "string", "font_family": "sans", "show_footer": true, "footer_text": "string", "header_letter_spacing": 0, "offer_greeting": "string", "offer_signature": "string", "public_available_works": true, "caption_fields": { "medium": true, "dimensions": true, "edition": true, "location": true, "work_status": true, "provenance": true, "exhibition_history": true, "literature": true, "catalogue_raisonne": true, "market": true, "price_date": true, "price_updated_at": true, "acquisition_value": true, "total_cost": true, "vat_status": true }, "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}Mint a signed logo upload URL POST
Returns a one-time signed target for uploading a branding logo. The client uploads the bytes, then PATCHes /gallery/branding with the returned storage_path. Requires a first-party session.
Create a condition report POST
Records a dated condition examination of an artwork. Creating one writes through to the artwork's current condition status/notes; it can bracket a custody transfer via `job_task_id` or stand alone.