Delete files
delete_filesPermanently delete specified files or folders from a CloudSee Drive bucket by their exact key and storage ID. Requires confirm=true and completes in background, typically under 2 minutes.
Instructions
Permanently delete one or more files/folders from a drive, each addressed by its exact object key plus its storage id (the StorageId field from search_files / browse_folder / get_file_metadata — not from list_files or recent_files, whose ids are a different id space and will NOT work). Queued: returns a RequestId per object and the deletes complete in the background, typically under 2 minutes — verify by listing until the objects disappear. Requires the drive (bucketName). Destructive and irreversible. Requires confirm=true. (Write access is authorized server-side by the public API's RBAC — a denial means the API key lacks this tool's scope, not a tool failure.)
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": {
"objects": "<objects>"
},
"name": "delete_files"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | No | Must be true to actually perform this mutating/irreversible action. If omitted or false, the tool returns a preview and makes no changes. | |
| objects | Yes | Objects to permanently delete (one queued request per object). | |
| bucketName | No | The CloudSee drive (S3 bucket) name to operate in, e.g. 'max-2778abc0' — find it in the CloudSee dashboard. Required unless CLOUDSEE_DEFAULT_BUCKET is configured on the server. |