List an asset's versions
Returns every retained rendering of one asset, ordered by position ascending — the uploaded original first, the current rendering last. Not paginated. Each entry’s version_urls follows the same include semantics as an asset’s asset_urls: lean thumbnail by default, include=variants for the remaining rungs and the exact-byte original.
Authorizations
Gumnut API key (apikey_...) sent as a Bearer token in the Authorization header. Create and manage keys in the Gumnut app, or with the API key endpoints while signed in to it.
Path Parameters
Asset ID (with asset_ prefix) whose versions to list.
Query Parameters
Optional response expansion. The single accepted value is variants: without it each row's version_urls carries only its lean thumbnail rung; with it, every rung plus the signed exact-byte original. Accepts multiple include= query params or a single comma-delimited value. Unknown values return 422.
Response
Successful Response
Unique version identifier with 'asset_version_' prefix
Zero-based index in the chain: 0 is the uploaded original, the highest is the current rendering.
What produced this rendering: original (the upload), edit (an edit rendered by the client), or external:<service>. The namespace is open — treat an unrecognized kind as opaque rather than failing.
MIME type of this rendering's bytes (e.g., 'image/jpeg')
Width of this rendering in pixels
Height of this rendering in pixels
Byte size of this rendering's stored bytes.
Base64-encoded SHA-256 hash of this rendering's stored bytes, for comparing a locally computed hash against the chain (e.g. when reconciling an ambiguous create failure). Not unique: identical bytes may legitimately appear at different positions or on other assets. Transitionally null for roots written during the column's rollout window, until a follow-up backfill lands.
How this rendering was produced (e.g. an edit recipe). Opaque to the server; the schema is defined by whichever producer sets kind. null only for the original.
URLs for this rendering, shaped like an asset's asset_urls: the lean thumbnail/thumbnail_image rung by default; include=variants adds the remaining rungs and original, this rendering's exact stored bytes.