assets

Update asset metadata

Updates the mutable metadata of an asset (name, tags, etc.). Binary content is immutable.

put/api/assets/{id}

Path parameters

idstring uuid required

The asset ID.

namestring

New display name for the asset

user_metadataobject

Custom user metadata to set

preview_idstring uuid

ID of the asset to use as the preview

mime_typestring nullable

[cloud-only] MIME type override when auto-detection was wrong. Ignored by local ComfyUI.

Asset updated

idstring uuid required

namestring

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.

tagsstring[]

mime_typestring

user_metadataobject

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

updated_atstring date-time required