Delete a task
delete_taskDelete ONE task by id (from get_tasks). On a repeating task, scope "occurrence" (the default) removes only one day (date, default today) and keeps the series; "series" deletes the whole repeating task. Use delete_inbox_item for Inbox items and delete_routine for routines. Returns {id, deleted:true}, or {deleted:false, scope:"occurrence", excludedDate} for one day; not_found means nothing changed. A deleted task cannot be restored. Preview rule: if this is the second task or routine change within about 90 seconds, nothing is saved and the result is needs_preview with the pending and saved changes - show them to the user and call again with confirm:true only after they agree.
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": {
"id": "<id>"
},
"name": "delete_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The task id from get_tasks, e.g. "aB3dE9". | |
| date | No | With scope "occurrence": the day to remove, YYYY-MM-DD. Default: the user's local today. | |
| scope | No | Repeating tasks only: "occurrence" (default) = just one day, "series" = the whole repeating task. Ignored for one-off tasks. | |
| confirm | No | Set true ONLY after the user has seen and approved this change in a preview you showed them (needed when a request changes more than one task or routine). Never set it on your own. Default false. |