Cancel a task
tasks_cancelCancel a task to stop polling a handle you no longer need. Updates task state without killing external processes, ensuring clean cleanup of unused tasks.
Instructions
Mark a task cancelled. Use to stop polling a handle you no longer need. Does not kill an external worker process — it only updates kernel state. Destructive relative to the handle, idempotent if already cancelled. Missing ids return cancelled=false. Prefer tasks_get first. Auth: tool policy gate.
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": {
"task_id": "<task_id>"
},
"name": "tasks_cancel"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | Task id to mark cancelled. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||