Gallery Platform API
Reference

Create a condition report

Records a dated condition examination of an artwork. Creating one writes through to the artwork's current condition status/notes; it can bracket a custody transfer via `job_task_id` or stand alone.

POST
/gallery/condition-reports

Records a dated condition examination of an artwork. Creating one writes through to the artwork's current condition status/notes; it can bracket a custody transfer via job_task_id or stand alone.

Authorization

bearerAuth jobs:create
AuthorizationBearer <token>

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

In: header

Scope: jobs: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.

Record a condition report for an artwork.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

{  "id": "string",  "artwork_id": "string",  "job_task_id": "string",  "examined_by": "string",  "examined_at": "string",  "status": "excellent",  "summary": "string",  "notes": "string",  "created_at": "string",  "updated_at": "string"}