Update a provenance entry
Edits one entry in the artwork's provenance: its parties or wording, kind, place, dates, source, document, visibility or note. Only the fields sent change. A key needs `contacts:read` to name a party, and to change an entry that names one, else 403 with `details.reason` `contacts_read_required`. Its place in the chain moves through `POST /gallery/artworks/{id}/provenance/reorder`.
Edits one entry in the artwork's provenance: its parties or wording, kind, place, dates, source, document, visibility or note. Only the fields sent change. A key needs contacts:read to name a party, and to change an entry that names one, else 403 with details.reason contacts_read_required. Its place in the chain moves through POST /gallery/artworks/{id}/provenance/reorder.
A gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artworks:read, artworks:update
Path Parameters
The artwork id.
The provenance id.
Query Parameters
Preview this operation without committing it. When true, the request is authenticated, scoped, and validated, but no side effect runs — no write, no idempotency claim, no audit event, no outbound delivery. The response is HTTP 200 with an X-Dry-Run: true header and a body of { "dry_run": true }, plus an effect object describing what the real call would change when this operation can resolve one.
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.
The fields of the provenance entry to change; the rest stay as they are.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "id": "string", "artwork_id": "string", "position": -9007199254740991, "kind": "sale", "from_party_id": "string", "to_party_id": "string", "from_label": "string", "to_label": "string", "place": "string", "starts_on": "string", "ends_on": "string", "date_precision": "year", "uncertain": true, "sale_id": "string", "ownership_id": "string", "source": "string", "document_id": "string", "visibility": "member", "note": "string", "created_at": "string", "updated_at": "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}Reorder an artwork's provenance POST
Puts the artwork's provenance entries in a new order, in one write. `entry_ids` names every entry of the work once, earliest first; a list that misses, repeats or adds an entry answers 400 naming each. A list in the current order changes nothing. A key needs `contacts:read` to move an entry that names a party, else 403 with `details.reason` `contacts_read_required`.
Publish an artwork POST
Publishes the artwork's current draft: snapshots a new version and makes it the live, publicly readable state.