files_delete
Permanently delete files from this workspace by their IDs (generated documents, uploads, screenshots, etc.).
IRREVERSIBLE: removes the DB record, detaches every reference (knowledge collections, thread pins, message attachments), and deletes the stored blob. There is no undo.
Use to clean up leftover / superseded generated files. Only files that belong to this workspace are touched; unknown or other-workspace ids are returned under not_found. Max 20 per call.
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": {
"file_ids": "<file_ids>"
},
"name": "files_delete"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_ids | Yes | List of file IDs to permanently delete (max 20). | |
| in_workspace | No | Run this one call in this workspace id instead of the session's. Nothing is stored; other sessions are not affected. |