Skip to main content
GET
/
api
/
assets
/
{id}
Get asset details
curl --request GET \
  --url https://cloud.comfy.org/api/assets/{id} \
  --header 'X-API-Key: <api-key>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "size": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "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.

Path Parameters

​
id
string<uuid>
required

Asset ID

Response

Asset details retrieved successfully

​
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

​
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)