board_delete_task
Delete a task and optionally its subtasks. Default safety restricts deletion to completed tasks to prevent accidental removal. Irreversible action.
Instructions
Hard-delete a task and optionally its subtasks. Safety guard: by default only allows deleting tasks with status=done (prevents deleting in-progress work). Pass require_done=false to override. Also deletes associated activity_log entries. This is irreversible — cannot be undone.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | Task ID to delete | |
| require_done | No | If true (default), refuse to delete unless the task's status is 'done'. Pass false to force-delete a non-done task. | |
| cascade_subtasks | No | If true, also delete all tasks with parent_task_id == task_id (each child also subject to require_done check). Default false — subtasks are orphaned but kept. |