Sign in
assets

Download assets to cloud runtime

[cloud-only] Initiates a download of one or more assets to the cloud runtime environment. Returns a task ID for tracking download progress via WebSocket.

post/api/assets/download

Request body

Response

File already exists in storage - asset created/returned immediately

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

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

created_newboolean required

Whether this was a new creation (true) or returned existing (false)

Changes