Gallery Platform API
ReferenceGalleryArtworksIdImages

Register an artwork image

Registers an already-uploaded object (from the upload-url endpoint) as an image row, appended to the end. Requires a first-party session.

POST
/gallery/artworks/{id}/images

Registers an already-uploaded object (from the upload-url endpoint) as an image row, appended to the end. Requires a first-party session.

Authorization

bearerAuth artworks:write
AuthorizationBearer <token>

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

In: header

Scope: artworks:write

Header Parameters

Idempotency-Key?string

Optional. Send a unique key per logical operation to make retries safe: a retry with the same key replays the stored success for 24h instead of re-running the write.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Register an uploaded image object as an artwork image.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/gallery/artworks/{id}/images" \  -H "Content-Type: application/json" \  -d '{    "storage_path": "string"  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "artwork_id": "1a900bf9-a284-4c99-a359-1f6b482d475f",  "storage_path": "string",  "url": "string",  "alt_text": "string",  "kind": "artwork",  "width": -9007199254740991,  "height": -9007199254740991,  "position": -9007199254740991,  "created_at": "string"}

List artwork images GET

Lists an artwork's images 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).

List artwork interests GET

Lists the contacts who have registered interest in an artwork (the "who's interested" view), newest first.