clickup_delete_task
DestructiveIdempotent
Permanently deletes a ClickUp task and its subtasks. Use when you are certain the task should be removed entirely, not just closed or archived.
Instructions
Permanently delete a task.
Calls DELETE /task/{task_id}. This removes the task (and its subtasks); it
cannot be undone via the API. Set custom_task_ids=true (+ team_id) to
address the task by Custom Task ID.
When to Use:
To remove a task you are certain should be gone.
When NOT to Use:
To merely close or archive a task — use
clickup_update_task(status/archived).
Returns: A confirmation string.
Examples:
params = {"task_id": "86cxy1"}
Error Handling: 404 means the task is already gone or the id is wrong.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |