Delete a task list
delete_tasklistPermanently delete a task list and all its tasks in one action. Use when you need to remove an entire list without recovery, while the default list remains protected.
Instructions
Deletes a task list AND every task in it, permanently — there is no undo and no trash. The user's default task list cannot be deleted (the API rejects it). To empty a list but keep it, use clear_completed_tasks or delete tasks one by one instead. Returns {deleted:true} with the tasklist_id echoed.
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": {
"tasklist_id": "<tasklist_id>"
},
"name": "delete_tasklist"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tasklist_id | Yes | The task list id — from list_tasklists or create_tasklist output. "@default" addresses the user's default list. |