userdata

List files in a userdata directory

Lists files in the authenticated user's data directory. Returns either filename strings or full objects depending on the full_info query parameter.

get/api/userdata

Query parameters

dirstring required

Directory path relative to the user's data folder

recurseboolean

Recurse into subdirectories

full_infoboolean

Return full file info objects instead of just names

splitboolean

Split paths into directory components

Headers

Comfy-Userstring

Identifies the active user in multi-user mode. Used for settings, userdata, and history isolation. This is not a security mechanism — it is an organisational convenience with no authentication behind it.

Response

File listing

OR
OR
string[] required

Default shape — array of file paths relative to the user data root.

Changes