List user data files

Returns a list of user data files in the specified directory, optionally recursively and with full metadata.

GET /api/userdata

List user data files

cURL

curl --request GET \
  --url https://cloud.comfy.org/api/userdata \
  --header 'X-API-Key: <api-key>'

200

[
  {
    "path": "<string>",
    "size": 123,
    "modified": 123
  }
]

授权

X-API-Key · string · header · 必填

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.

查询参数

dir · string · 必填

The directory path to list files from. Must include trailing slash. Example: "workflows/" or "settings/"

recurse · boolean · 默认值: false

If true, include files in subdirectories. Otherwise only lists files directly in the specified directory.

split · boolean · 默认值: false

Whether to split file information by type. Note: Accepted for ComfyUI API compatibility but currently ignored.

full_info · boolean · 默认值: false

Whether to return full file metadata. Note: Accepted for ComfyUI API compatibility but currently ignored (always returns full info).

响应

200

application/json

A list of user data files.

path · string

File name or path relative to the user directory.

size · integer

File size in bytes.

modified · number<float>

UNIX timestamp of the last modification.