Restore an artist version
Stages a past version as the artist's working draft (non-destructive — save to make it current).
Stages a past version as the artist's working draft (non-destructive — save to make it current).
Authorization
bearerAuth artists:updateA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artists:update
Path Parameters
The artist id.
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.
Restore a past version into the record's working draft.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "id": "string", "name": "string", "sort_name": "string", "nationality": "string", "birth_year": -9007199254740991, "death_year": -9007199254740991, "biography": "string", "website_url": "string", "pronouns": "string", "birthplace": "string", "based_in": "string", "statement": "string", "cv_url": "string", "socials": { "property1": "string", "property2": "string" }, "public_email": "string", "public_phone": "string", "party_id": "string", "visibility": "private", "metadata": { "property1": "string", "property2": "string" }, "created_at": "string", "updated_at": "string", "save_state": "new"}{ "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}Merge an artist POST
Merges the artist `merged_id` into this one through its Party: its artworks, show line-ups, images, documents, representation history and account claims re-point to this artist, the two Parties merge, and the merged artist is removed. The merged id keeps reading as this artist. Refused with 409 while either artist has an active studio connection. Confirmation-gated: pass `confirm: true`. Cannot be undone.
Save an artist POST
Saves the artist's pending edits: promotes them onto the record and snapshots a new version.