Delete a provenance entry
Deletes one entry from the artwork's provenance (it cannot be undone); the later entries move up one. The parties it named are untouched. A key needs `contacts:read` to delete an entry that names a party or sits ahead of one, else 403 with `details.reason` `contacts_read_required`.
Deletes one entry from the artwork's provenance (it cannot be undone); the later entries move up one. The parties it named are untouched. A key needs contacts:read to delete an entry that names a party or sits ahead of one, else 403 with details.reason contacts_read_required.
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.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "artwork_id": "string", "entry_id": "string", "deleted": true}{ "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}Record a provenance entry POST
Adds one entry to the artwork's provenance at `position` (from 1), moving later entries down one, or last without a position. Name each end by a party of this gallery or by wording such as “Private collection, Paris”; an entry needs at least one. A key needs `contacts:read` to name a party, or to land the entry ahead of one that names a party, else 403 with `details.reason` `contacts_read_required`. `public` visibility shows the entry's labels, never a party, on the published work.
List an artwork's provenance GET
Lists the artwork's provenance entries in chain order, earliest first: who the work moved from and to (a party or wording), how, where, when and on what evidence. Entries name parties, so a key needs an artworks write scope or `contacts:read`; an `artworks:read`-only key gets 403. A published work's public wording reaches any key at `GET /gallery/artworks/{id}/provenance/public`.