Accept a consignment proposal
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.
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.
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
{ "proposal": { "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" }, "artwork_id": "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}Render a condition report PDF POST
Renders one condition report — the artwork tombstone, the examination date and condition status, and the summary and notes — to a branded PDF and returns a short-lived signed download URL.
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.