Re-enqueue this asset's preview job

POST

/assets/{id}/preview

• Local development behind nginx (port 8088 by default)

Inserts a fresh job of the preview kind that matches the asset’s file extension (preview.raster / preview.video / preview.3d / preview.audio / preview.pdf / preview.font / preview.ebook / preview.eps / preview.psd / preview.comic / preview.text) at PriorityHigh. The worker picks it up within a tick and overwrites the existing variants when its idempotency-skip logic doesn’t bail.

Useful after attaching new companions (so a 3D model can re-render with its textures) or after a worker bug-fix landed and the user wants the existing rendered output regenerated against the new code.

Returns the freshly-enqueued job id so callers can poll /jobs/{id}/status if they want a progress UI.

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Responses

202

Job enqueued

object

job_id

required

string format: uuid

job_type

required

string

400

Malformed request

object

error

required

Human-readable error summary

string

Example

the request could not be completed

401

Authentication required, missing, or invalid

object

error

required

Human-readable error summary

string

Example

the request could not be completed

Example

{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

404

Resource not found

object

error

required

Human-readable error summary

string

Example

the request could not be completed

500

Unexpected server error

object

error

required

Human-readable error summary

string

Example

the request could not be completed