assets

List an asset's versions

Changed on

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.

get/api/assets/{asset_id}/versions

Request

  • Base URL: https://api.gumnut.ai
  • URL: https://api.gumnut.ai/api/assets/{asset_id}/versions
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

asset_idstring required

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

Query parameters

includestring[] nullable

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

idstring required

Unique version identifier with 'asset_version_' prefix

positioninteger required

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

kindstring required

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.

paramsobject nullable

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.

mime_typestring required

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

widthinteger required

Width of this rendering in pixels

heightinteger required

Height of this rendering in pixels

file_size_bytesinteger required

Byte size of this rendering's stored bytes.

checksumstring nullable required

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.

version_urlsobject nullable

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.

Changes

  • 7c2860d9eb88Revision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 815e0302a988Revision changes
    • breaking

      response property detail list-of-types was widened by adding types string to media type application/json of response 422

    • info

      the response property became required for the status