Preview a work to scale in a room
Renders the work hanging to true scale in the chosen room scene and returns a short-lived signed image URL. Deterministic and cached by storage path.
Renders the work hanging to true scale in the chosen room scene and returns a short-lived signed image URL. Deterministic and cached by storage path.
Authorization
bearerAuth artworks:readA gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).
In: header
Scope: artworks:read
Path Parameters
The artwork id.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Render this work to scale in the given room scene.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
{ "preview_url": "string"}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "invalid_request", "retry": "permanent", "details": null}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.
Save an artwork POST
Saves the artwork's pending edits: promotes them onto the record and snapshots a new version. Publication is unchanged — use `/go-live` to serve the saved version publicly.