Create asset reference from existing hash

Creates a new asset reference using an existing hash from cloud storage. This avoids re-uploading file content when the underlying data already exists, which is useful for large files or when referencing well-known assets. The user provides their own metadata and tags for the new reference.

POST /api/assets/from-hash

Create asset reference from existing hash

cURL

curl --request POST \
  --url https://cloud.comfy.org/api/assets/from-hash \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "hash": "<string>",
  "tags": [
    "<string>"
  ],
  "name": "<string>",
  "mime_type": "<string>",
  "user_metadata": {}
}
'

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "size": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "created_new": true,
  "asset_hash": "<string>",
  "mime_type": "<string>",
  "tags": [
    "<string>"
  ],
  "user_metadata": {},
  "preview_url": "<string>",
  "preview_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "prompt_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "last_access_time": "2023-11-07T05:31:56Z",
  "is_immutable": true
}

Authorizations

X-API-Key · string · header · required

API key authentication. Generate an API key from your account settings at https://comfy.org/account. Pass the key in the X-API-Key header.

Body

application/json

hash · string · required

Hash of the existing asset. Supports Blake3 (blake3:) or SHA256 (sha256:) formats

tags · string[] · required

Freeform tags for the asset. Common types include "models", "input", "output", and "temp", but any tag can be used in any order.

Minimum array length: 1

name · string

Display name for the asset reference (optional)

mime_type · string

MIME type of the asset (e.g., "image/png", "video/mp4")

user_metadata · object

Custom metadata for this asset reference

Response

200

application/json

Asset reference already exists (returned existing)

id · string<uuid> · required

Unique identifier for the asset

name · string · required

Name of the asset file

size · integer<int64> · required

Size of the asset in bytes

created_at · string<date-time> · required

Timestamp when the asset was created

updated_at · string<date-time> · required

Timestamp when the asset was last updated

created_new · boolean · required

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

asset_hash · string

Blake3 hash of the asset content

mime_type · string

MIME type of the asset

tags · string[]

Tags associated with the asset

user_metadata · object

Custom user metadata for the asset

preview_url · string<uri>

URL for asset preview/thumbnail

preview_id · string<uuid> | null

ID of the preview asset if available

prompt_id · string<uuid> | null

ID of the job/prompt that created this asset, if available

last_access_time · string<date-time>

Timestamp when the asset was last accessed

is_immutable · boolean

Whether this asset is immutable (cannot be modified or deleted)