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 (a client-baked edit), 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.
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.