Skip to main content
GET
List an asset's versions

Authorizations

Authorization
string
header
required

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
string
required

Asset ID (with asset_ prefix) whose versions to list.

Query Parameters

include
string[] | null

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

id
string
required

Unique version identifier with 'asset_version_' prefix

position
integer
required

Zero-based index in the chain: 0 is the uploaded original, the highest is the current rendering.

kind
string
required

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
string
required

MIME type of this rendering's bytes (e.g., 'image/jpeg')

width
integer
required

Width of this rendering in pixels

height
integer
required

Height of this rendering in pixels

file_size_bytes
integer
required

Byte size of this rendering's stored bytes.

params
Params · object | null

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.

version_urls
Version Urls · object | null

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.