Delete task by UUID or shortNumber
Soft deletes a task by its UUID or numeric shortNumber identifier. The task is marked as deleted but remains in the database for historical purposes. Access is controlled by Tasks.delete permission and project access. Billed tasks cannot be deleted to maintain billing integrity. Parent/subtask relationships are handled automatically - removing a parent task does not delete its subtasks, but removes the parent-child relationship. Organization members can only delete tasks with guestAccess enabled.
/tasks/{identifier}AuthorizationOAuth2 access token · headerrequiredapi:writeAuthorizationBearer token (JWT) · headerrequiredidentifierstringrequiredTask UUID or numeric shortNumber
Task deleted successfully
successbooleanrequiredOperation success flag
Invalid identifier format (not UUID and not numeric) or task is billed
Unauthorized - Invalid or missing authentication token
Access denied: No Tasks.delete permission, no project access, or OrganizationMember accessing non-guest task
Task not found