Gallery Platform API
ReferenceGalleryArtworksIdImages

List artwork images

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

GET
/gallery/artworks/{id}/images

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

Authorization

bearerAuth artworks:read
AuthorizationBearer <token>

A 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/artworks/{id}/images"
{  "data": [    {      "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"    }  ]}

Update an artwork format PATCH

Patches a format's editable fields (label, dimensions, medium, edition size, stock, availability, price). Only supplied fields change.

Register an artwork image POST

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