list_files
Read-only
List direct files and folders in a folder, up to 200 per page, sorted by name, size, or updated time. Identify by parent_id or absolute path, or omit both for root.
Instructions
List the direct children (files and folders) of one folder, up to 200 per page, sorted by name (default), size or updated_at. Identify the folder by parent_id or absolute path; omit both for the root. Each item has id, kind, size, mime and updated_at; the result also has total and next_cursor, which you pass back as cursor for the next page. Does not recurse: to find items anywhere in the drive use search_files (by name) or search_file_contents (by text inside files). Requires files:read.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| desc | No | sort descending | |
| path | No | absolute folder path instead of parent_id | |
| order | No | sort order: name, size, or updated_at | |
| cursor | No | cursor returned by the previous call | |
| parent_id | No | folder node ID; omit for root |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| total | Yes | ||
| next_cursor | No |