Skip to main content
GET
List user data files

Authorizations

X-API-Key
string
header
required

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

Query Parameters

dir
string
required

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

recurse
boolean
default:false

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

split
boolean
default:false

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

full_info
boolean
default:false

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

Response

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.