Sign in
assets

Create an asset reference from an existing hash

Registers a new asset that references existing content by hash, without re-uploading the bytes.

post/api/assets/from-hash

Request body

hashstring required

Blake3 hash of existing content

namestring required

Display name

tagsstring[]
user_metadataobject
mime_typestring nullable

[cloud-only] MIME type of the content, so the type is preserved without re-inspecting content. Ignored by local ComfyUI.

Response

Asset created from hash

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

created_newboolean required

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

Changes