Gallery Platform API
ReferenceGalleryArtworksIdFormatsFormatid

Delete an artwork format

Permanently deletes a format/variant from an artwork.

DELETE
/gallery/artworks/{id}/formats/{formatId}

Permanently deletes a format/variant from an artwork.

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.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X DELETE "https://example.com/gallery/artworks/{id}/formats/{formatId}"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "deleted": true}

Create an artwork format POST

Adds a sellable format/variant to an artwork, appended to the end. A supplied price writes the gated pricing sibling. Rejected on an edition umbrella (only its copies or a standalone work are sellable).

Update an artwork format PATCH

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