Reorder an artist's images
Sets each image's position from its index in the supplied order. Ids not on the artist are ignored. Requires a first-party session.
Sets each image's position from its index in the supplied order. Ids not on the artist are ignored. Requires a first-party session.
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
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.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Reorder an artist's images by supplying the image ids in order.
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", "artist_id": "string", "storage_path": "string", "url": "string", "alt_text": "string", "kind": "headshot", "position": -9007199254740991, "created_at": "string" } ]}{ "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}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).
Update an artist image PATCH
Updates an image's editable fields (alt text, kind). Requires a first-party session.