What it does
List files and directories in the Undisk workspace. Returns metadata for each entry including path, size, and last-modified timestamp. Each result includes abrowser_url — a permanent link the human user can open in their browser to view the file. Use recursive mode to get the full workspace tree. Start here to discover what files are available before reading or writing. Returns up to 1,000 entries per call. For larger directories, use search_files or navigate subdirectories explicitly. Note: results are consistent within a sequential request chain but may not reflect writes from concurrent parallel requests.
Required scope
files:read
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path | string | No | Directory path to list (default: ’/’ for workspace root) |
recursive | boolean | No | If true, includes all files in subdirectories recursively |