list_files
Browse folder entries and document IDs in a Connapse container to answer inventory questions like "what files exist here." Returns file metadata only, not file contents.
Instructions
Lists folder entries and document IDs at a path within a container (does NOT return file contents — for content questions, use search_knowledge). Intended for inventory requests such as 'what files exist in X' or when the user named a specific filename. Large listings return a soft error directing you to search_knowledge; override with confirmLarge: true or paginate with limit. Each file shows when it was added and, if since changed, when it was updated. For the newest N entries of a folder, pass sort: "newest" and limit: N, then read them all with get_documents.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"containerId": "<containerId>"
},
"name": "list_files"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | Folder path to list (default: root '/') | |
| sort | No | Leave unset for folders by name, then files newest first. "name": every entry by name, folders first, so `limit` keeps the first names. "newest": every entry most recently added first, so `limit` keeps the newest. | |
| limit | No | Maximum number of entries to return. When set, large listings are truncated instead of returning a soft error. Recommended: 25. | |
| containerId | Yes | Container ID or name | |
| confirmLarge | No | Set to true to confirm you intentionally want the full listing of a large folder. Without this, listings exceeding the soft limit return an error directing you to `search_knowledge`. |