Discard an artist's draft
Drops the pending draft, reverting the working copy to the last saved state. The saved artist is unchanged.
Drops the pending draft, reverting the working copy to the last saved state. The saved artist is unchanged.
Authorization
bearerAuth artists:deleteA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artists:delete
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.
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", "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}Delete an artist DELETE
Removes an artist from the roster. Any artworks keep their catalogue entry with the maker cleared; the artist's show lineups, images, and documents are removed. To combine duplicate makers instead, use merge.
Register an artist document POST
Registers an already-uploaded object (from the upload-url endpoint) as a document row, appended to the end. Requires a first-party session.