Gallery Platform API
Reference

Get an artwork

Returns the published artwork. Pass `draft=true` to get the editor's working copy (pending edits overlaid).

GET
/gallery/artworks/{id}

Returns the published artwork. Pass draft=true to get the editor's working copy (pending edits overlaid).

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

Path Parameters

id*string

Query Parameters

draft?string

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"}

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.