Gallery Platform API
Reference

Create a custom-field definition

Adds a custom-field definition to the gallery's catalog for a resource type.

POST
/gallery/resource-fields

Adds a custom-field definition to the gallery's catalog for a resource type.

Authorization

bearerAuth gallery:create
AuthorizationBearer <token>

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

In: header

Scope: gallery:create

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.

Create a custom-field definition for a resource type.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

{  "id": "string",  "owner_type": "artwork",  "group_label": "string",  "name": "string",  "field_type": "string",  "options": null,  "position": -9007199254740991,  "is_public": true,  "created_at": "string",  "updated_at": "string"}

Render the insurance schedule PDF POST

Renders the gallery's insurance schedule — effective insured values, policy and appraisal freshness, base-currency total — to a branded PDF and returns a short-lived signed download URL.

Delete a custom-field definition DELETE

Removes a field definition and cascades its stored values.