Gallery Platform API
Reference

List artists

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.

GET
/gallery/artists

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.

Authorization

bearerAuth artists:read
AuthorizationBearer <token>

A gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).

In: header

Scope: artists:read

Query Parameters

limit?integer
Range1 <= value <= 100
Default20
cursor?string
q?string
Lengthlength <= 200

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

{  "data": [    {      "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"    }  ],  "next_cursor": "string"}

List artist images GET

Lists an artist's images (headshots, studio, install shots) in display order, each with a short-lived signed download URL (null when the caller can't sign the private object, e.g. an API key).

Merge an artist POST

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`.