Gallery Platform API
Reference

Mint a signed show-image upload URL

Returns a one-time signed target for uploading an installation image directly to Storage. The server derives the gallery-scoped object key; the client then uploads the bytes and registers the object via POST /images. Requires a first-party session.

POST
/gallery/shows/{showId}/images/upload-url

Returns a one-time signed target for uploading an installation image directly to Storage. The server derives the gallery-scoped object key; the client then uploads the bytes and registers the object via POST /images. Requires a first-party session.

Authorization

bearerAuth shows:create
AuthorizationBearer <token>

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

In: header

Scope: shows:create

Path Parameters

showId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request a signed URL to upload an image object.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

{  "storage_path": "string",  "token": "string",  "signed_url": "string"}

Reorder a show's installation images POST

Sets each image's position from its index in the supplied order. Ids not on the show are ignored. Requires a first-party session.

List shows GET

Lists the gallery's shows — exhibitions and art fairs — newest first, with cursor pagination. Filter by show_type, visibility, or a title query.