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.

DELETE/tasks/{identifier}

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

identifierstringrequired

Task UUID or numeric shortNumber

Responses

200Task deleted successfully

successbooleanrequired

Operation success flag

400Invalid identifier format (not UUID and not numeric) or task is billed

401Unauthorized - Invalid or missing authentication token

403Access denied: No Tasks.delete permission, no project access, or OrganizationMember accessing non-guest task

404Task not found

Request

curl -X DELETE "https://leadtime.app/api/public/tasks/550e8400-e29b-41d4-a716-446655440000%20or%20123" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/tasks/550e8400-e29b-41d4-a716-446655440000%20or%20123", {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.delete(
    "https://leadtime.app/api/public/tasks/550e8400-e29b-41d4-a716-446655440000%20or%20123",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

{
  "success": true
}