Delete a task
Permanently deletes a task.
The API key’s owner 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.
Requests for tasks they don’t have access to return 403 Forbidden.
Connected web clients in the team receive a task:deleted realtime event
so the task disappears from their UI.
Request
Section titled “Request”Path parameters
Section titled “Path parameters”| Name | Type | Required | Description |
|---|---|---|---|
taskId | string | yes | Numeric ID of the task. |
No request body.
Response
Section titled “Response”200 OK:
Errors
Section titled “Errors”| Status | Body | When |
|---|---|---|
400 | { "error": "taskId must be a number." } | taskId path parameter is not numeric. |
403 | { "error": "You do not have access to this task." } | The API key’s owner can’t see this task in the web app either. |
404 | { "error": "Task <id> not found." } | No task with that ID exists in the bound team. |