Sign in
assets

Get asset metadata

Returns the metadata for a single asset.

get/api/assets/{id}

Path parameters

idstring uuid required

The asset ID.

Response

Asset metadata

idstring uuid required

Unique identifier for the asset

namestring required

Name of the asset file

hashstring nullable

Blake3 content hash of the asset (preferred over asset_hash)

asset_hashstring nullable

Deprecated: use hash instead. Blake3 hash of the asset content.

sizeinteger required

Size of the asset in bytes

widthinteger nullable

Original image width in pixels. Null for non-image assets or assets ingested before dimension extraction.

heightinteger nullable

Original image height in pixels. Null for non-image assets or assets ingested before dimension extraction.

mime_typestring

MIME type of the asset

tagsstring[]

Tags associated with the asset

user_metadataobject

Custom user metadata

metadataobject

System-managed metadata (read-only)

preview_urlstring uri

URL for asset preview/thumbnail

preview_idstring uuid

ID of the preview asset if available

prompt_idstring uuid nullable

Deprecated: use job_id instead. ID of the prompt that created this asset.

job_idstring uuid nullable

ID of the job that created this asset

created_atstring date-time required
updated_atstring date-time required
last_access_timestring date-time
is_immutableboolean

Whether this asset is immutable

Changes