Decline a consignment proposal
Declines a live proposal from the receiving side. Nothing is copied; the proposing side may pitch the work again later.
Declines a live proposal from the receiving side. Nothing is copied; the proposing side may pitch the work again later.
Authorization
bearerAuth artists:writeA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artists:write
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.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "id": "string", "connection_id": "string", "direction": "studio_to_gallery", "status": "proposed", "source_artwork_id": "string", "result_artwork_id": "string", "proposed_split_bps": 0, "payload": { "title": "string", "year": -9007199254740991, "medium": "string", "dimensions_text": "string", "price_cents": -9007199254740991, "currency": "string" }, "decided_at": "string", "created_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}Create a consignment proposal POST
Proposes one of this gallery's works across an artist connection (docs §8.5). Studio callers pitch the work to the representing gallery; gallery callers offer the work into the connected artist's studio catalog. The direction follows from which side of the connection the caller is.
List consignment proposals GET
Lists consignment-handoff proposals where this gallery is either side of the connection — incoming and outgoing in one list; `direction` tells them apart. Filter with ?status= or ?direction=.