Create a consignment proposal
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.
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.
Authorization
bearerAuth artists:writeA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artists:write
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.
Propose one of your works across an artist connection. Studio callers pitch to the gallery; gallery callers offer the work into the studio's catalog.
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}Accept a consignment proposal POST
Accepts from the receiving side. A studio pitch materializes the work in this gallery — public-safe fields, the consignment (with the proposed or represented split), and the connected-works pair. An offered work copies into this studio's own catalog — works are never capped by plan.
Decline a consignment proposal POST
Declines a live proposal from the receiving side. Nothing is copied; the proposing side may pitch the work again later.