Create an artist
Adds an artist to the gallery's roster — the deliberate alternative to the silent mint when a name is typed into the artwork form. `name` is required; the profile fields are optional. A duplicate name (case-insensitive) is rejected.
Adds an artist to the gallery's roster — the deliberate alternative to the silent mint when a name is typed into the artwork form. name is required; the profile fields are optional. A duplicate name (case-insensitive) is rejected.
Authorization
bearerAuth artists:createA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artists:create
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.
Create an artist in the gallery's roster.
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}Resend an artist invitation POST
Re-issues a pending artist invitation: mints a fresh claim token, resets the 7-day expiry, and re-emails the artist. Requires an Idempotency-Key header (the email is an irreversible side effect): a retry with the same key replays the original result for 24h instead of emailing again.
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.