delete_task

delete_task

Permanently delete a task. The authenticated user must have access to the task — they created it, are assigned to it, or belong to one of the lists the task is attached to.

Connected web clients receive a task:deleted realtime event so the task disappears from their UI.

Input

Field	Type	Required	Description
taskId	number	yes	Numeric ID of the task to delete.

Example call

{
  "taskId": 421
}

Output

A single text content block:

{ "ok": true }

Errors

The tool returns isError: true with an explanatory text block when the task ID doesn’t exist or the authenticated user has no access to it.