Merge an artist
Merges the loser artist into this one, re-pointing its artworks, show line-ups, images, documents, representation history, and contact link, then removing it. Requires gallery-editor rights. Confirmation-gated: echo the loser id and pass `confirm: true`.
Merges the loser artist into this one, re-pointing its artworks, show line-ups, images, documents, representation history, and contact link, then removing it. Requires gallery-editor rights. Confirmation-gated: echo the loser id and pass confirm: true.
Authorization
bearerAuth artists:createA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artists:create
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.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Merge the loser artist into this one.
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", "created_at": "string"}{ "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}List artists GET
Lists the gallery's artists, newest first, with cursor pagination. Pass `q` to match by name — use this to resolve an artist name to an id for the artwork `artist_id` filter. The roster is gallery-scoped; RLS returns it only to principals that can read the gallery.
Update an artist PATCH
Updates an artist's editable fields (name, filing name, biography, statement, CV, socials, published contact). Only the fields you pass change.