Add a tag to a sale
Adds a single tag to this sale (idempotent — never clobbers its other tags). Returns the resulting tag set.
Adds a single tag to this sale (idempotent — never clobbers its other tags). Returns the resulting tag set.
Authorization
bearerAuth sales:updateA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: sales:update
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
{ "data": [ { "id": "string", "name": "string", "color": "slate", "facet": "medium", "created_at": "string", "updated_at": "string", "origin": "manual" } ]}{ "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}Get a sale's three-way split breakdown GET
Returns the per-party split of a sale, net of production costs: the consignor and third-party legs (mirroring the generated payables) plus the gallery's residual consignee share, with amounts booked at the sale's frozen rate. A missing or unauthorized sale is a 404.
Remove a tag from a sale DELETE
Removes a single tag from this sale (idempotent). Returns the resulting tag set.