delete_todo
Permanently delete a To-Do item. WARNING: This action cannot be undone. ADMIN ONLY: This tool requires admin privileges. Non-admin users will receive a 403 Forbidden error from the API.
delete_todo
When to use
Permanently delete a To-Do item. WARNING: This action cannot be undone. ADMIN ONLY: This tool requires admin privileges. Non-admin users will receive a 403 Forbidden error from the API.
Parameters to validate before calling
todo_token (string, required) — The To-Do token to delete (UUID format).
Notes
DESTRUCTIVE — IRREVERSIBLE. Always confirm with the user before calling. Explain what will be lost.
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": {
"todo_token": "<todo_token>",
"confirm": "<confirm>"
},
"name": "delete_todo"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | Yes | Must be true. Set it ONLY after the user explicitly confirmed THIS deletion in this conversation, having been told what is lost: the to-do item. Never assume, never carry a confirmation over from a previous item, never set it to satisfy the schema. | |
| todo_token | Yes | The To-Do token to delete (UUID format). |