Delete task

Deletes a task and every descendant beneath it. There is no separate “delete children” step — deleting a group task removes the whole subtree in one call.

On success the API returns 204 No Content. A delete that would cascade through more than 20 levels of nesting is rejected with 400 too_deep — nothing is deleted.

Path parameters

NameTypeRequiredDescription
taskIdstring (uuid)YesThe task (and subtree) to delete.