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
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": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "retry": "permanent", "details": null}{ "type": "../dictionary", "title": "string", "status": 0, "detail": "string", "code": "string", "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.
Find visually similar artworks GET
Returns artworks whose cover image is visually most similar to this one, most similar first, excluding the artwork itself. Empty until the work has been indexed by the visual-embedding worker.