Get an artist
Get one artist in the gallery's organization by id.
Get one artist in the gallery's organization by id.
Authorization
bearerAuth artworks:readA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artworks:read
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/gallery/artists/{id}"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "sort_name": "string", "nationality": "string", "birth_year": -9007199254740991, "death_year": -9007199254740991, "biography": "string", "website_url": "string", "created_at": "string"}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "details": null}List artists GET
Lists the artists in the gallery's organization, 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 org-scoped; RLS returns it only to members of the gallery's organization.
List artworks GET
Lists the gallery's artworks, newest first, with cursor pagination. Pass `draft=true` to get the editor's working copy (pending edits overlaid) instead of the published state.