Reference
List holds
Lists the gallery's holds with cursor pagination, newest first. Filter by `artwork_id` or `party_id`.
Lists the gallery's holds with cursor pagination, newest first. Filter by artwork_id or party_id.
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
Query Parameters
limit?integer
Page size. Defaults to 20; the maximum is 100.
Range
1 <= value <= 100Default
20cursor?string
Opaque cursor from the previous page's next_cursor. Omit for the first page.
artwork_id?string
Filter to the given artwork id.
party_id?string
Filter to the given party id.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "data": [ { "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" } ], "next_cursor": "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}