Gallery Platform API
Reference

Restore an artwork version

Stages a past version as the artwork's working draft (non-destructive — re-publish to make it live).

POST
/gallery/artworks/{id}/restore

Stages a past version as the artwork's working draft (non-destructive — re-publish to make it live).

Authorization

bearerAuth artworks:create
AuthorizationBearer <token>

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

In: header

Scope: artworks:create

Path Parameters

id*string

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

Restore a past version into the artwork's working draft.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

{  "id": "string",  "title": "string",  "artist_id": "string",  "artist_name": "string",  "thumbnail_url": "string",  "inventory_number": "string",  "ownership_status": "owned",  "availability_state": "available",  "status": "available",  "medium": "string",  "year": -9007199254740991,  "description": "string",  "dimension_unit": "in",  "height_cm": 0,  "width_cm": 0,  "depth_cm": 0,  "framed_height_cm": 0,  "framed_width_cm": 0,  "framed_depth_cm": 0,  "dimensions_text": "string",  "location": "string",  "location_id": "string",  "price_cents": -9007199254740991,  "currency": "string",  "is_edition": true,  "edition_number": -9007199254740991,  "edition_size": -9007199254740991,  "edition_type": "numbered",  "edition_overrides": [    "string"  ],  "parent_artwork_id": "string",  "coa_status": "not_required",  "coa_tracking_number": "string",  "condition_status": "excellent",  "condition_notes": "string",  "provenance": "string",  "exhibition_history": "string",  "literature": "string",  "catalogue_raisonne": "string",  "market": "primary",  "custom_status_id": "string",  "show_price_publicly": true,  "published_at": "string",  "published_version": -9007199254740991,  "source_system": "string",  "source_external_id": "string",  "formats": [    {      "id": "string",      "artwork_id": "string",      "label": "string",      "height_cm": 0,      "width_cm": 0,      "depth_cm": 0,      "dimension_unit": "in",      "medium": "string",      "edition_size": -9007199254740991,      "stock_quantity": -9007199254740991,      "availability_state": "available",      "price_cents": -9007199254740991,      "currency": "string",      "position": -9007199254740991,      "metadata": {        "property1": "string",        "property2": "string"      },      "created_at": "string",      "updated_at": "string"    }  ],  "metadata": {    "property1": "string",    "property2": "string"  },  "created_at": "string",  "updated_at": "string"}

Check a document's artwork list against inventory POST

Reads an already-uploaded PDF or image (in the gallery-documents bucket), extracts one artwork draft per listed work, and diffs each against existing inventory — the reconcile sibling of extract-from-document. Matching is by title + resolved artist (unambiguous title-only fallback); the report carries per-field ours-vs-theirs diffs for matches, document rows with no inventory match, and (capped, informational) the matched artists' works the document does not list. Read-only: nothing is written — applying a proposed change is a separate, opt-in artwork update. Requires a first-party session.

Restore a soft-deleted artwork POST

Restores a soft-deleted artwork, returning it to every read surface. Only a deleted (tombstoned) artwork is eligible — a live or absent artwork 404s. The inverse of DELETE /gallery/artworks/{id}; not to be confused with POST /gallery/artworks/{id}/restore, which restores a published version.