Reference
Get a hold
Returns one hold.
Returns one hold.
Authorization
bearerAuth artworks:update, contacts:readAuthorizationBearer <token>
A gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artworks:update, contacts:read
Path Parameters
id*string
The hold id.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "id": "string", "artwork_id": "string", "party_id": "string", "ends_on": "string", "released_at": "string", "released_reason": "string", "note": "string", "created_at": "string", "updated_at": "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}Extend a hold POST
Moves an active hold's release date (`ends_on`) later. An earlier or equal date answers 400; to end a hold sooner, release it. A released hold, or one whose release date has passed, answers 409. The work stays on hold for the same party.
List holds GET
Lists the gallery's holds with cursor pagination, newest first. Filter by `artwork_id` or `party_id`.