list_files
List the folder + file children of a Files surface (kind='files'). Folders sorted first by position then name; files sorted by name. Returns folders[], files[] with cuids agents can pass to get_file / delete_file. parent_folder_id defaults to null (= root of the surface); pass a folder id to descend into a sub-folder.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | The workspace slug. Accepts either the bare slug or the org-prefixed form ('my-org/my-workspace') as shown in the dashboard URL. | |
| surface_slug | Yes | Files-kind surface slug within the workspace. Use list_surfaces to enumerate; the Files surface kind is 'files'. | |
| parent_folder_id | No | Folder id to descend into. Omit (or pass null) for the surface root. |