list_documents
List the authenticated user/org's saved documents, most-recently-updated first (metadata only — no document content). Each carries a session_count ("N chats"). Documents become durable + reusable automatically as you create or edit them; on the FIRST call we also one-time import the documents of pre-Files-view chats so prior work appears here too. Pass archived=true to browse the soft-deleted set (the Files "Archived" filter).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_documents"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of documents to return. | |
| offset | No | Offset for pagination. | |
| archived | No | When true, list your ARCHIVED (soft-deleted) documents instead of the live set — backs the Files view's Archived filter. Restore one with POST /v1/documents/{document_id}/unarchive. | |
| include_preview | No | Include a small preview_html (first chunks) per document for thumbnails. The web Files view sets this; agents leave it off to stay token-light. |