Deletes a file by fileId from list_files. If fileId is unknown, pass fileName: only an exact name match (case-insensitive, extension optional) is deleted; othe…
Use with an AI agent
Export this page as Markdown or bundle it with a task for your agent.
Try a task
Preview the prompt that will be copied
Access
- Effect: Deletes data
- Required scope:
write(themcpscope also grants it)
Example request
The JSON-RPC message an MCP client sends to call this tool. Your client builds it for you; this is for reference and debugging in a tool such as MCP Inspector.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "delete_file",
"arguments": {}
}
}Example IDs refer to fictional demo data. Replace them with IDs from your account before calling the real server.
Description
Deletes a file by fileId from list_files. If fileId is unknown, pass fileName: only an exact name match (case-insensitive, extension optional) is deleted; otherwise the tool returns the candidate files to ask about.Input parameters
| Name | Type | Required | Description |
|---|---|---|---|
fileId | string | No | |
fileName | string | No |
Full input schema (JSON Schema)
{
"additionalProperties": false,
"properties": {
"fileId": {
"type": "string"
},
"fileName": {
"type": [
"null",
"string"
]
}
},
"type": "object"
}