Delete (soft delete) a todo from a component item

Deletes a todo item from a project component item (soft delete - sets deletedAt timestamp). Todos are checklist items within component items (epics, features, tasks) that can be marked as complete and have comments. This endpoint validates that the todo exists and belongs to a component item in the specified project. The service automatically triggers condition cleanup (removes conditions targeting the deleted todo), recalculates conditions if needed, and marks the project configuration as changed.

DELETE/projects/{projectId}/items/{itemId}/todos/{id}

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

projectIdstringrequired

Project UUID

itemIdstringrequired

Component item UUID. Items are the building blocks within components (Epics, Work Packages, Todo Lists, Test Suites).

idstringrequired

Todo UUID

Responses

200Todo deleted successfully

successboolean

400Invalid projectId, itemId, or todo id format

401Unauthorized - Invalid or missing authentication token

403Insufficient permissions to manage components or no access to project

404Todo not found, component item not found, or item does not belong to the project

Request

curl -X DELETE "https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/3047983b-d798-4aff-8dd4-628cf1900703/todos/550e8400-e29b-41d4-a716-446655440011" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/3047983b-d798-4aff-8dd4-628cf1900703/todos/550e8400-e29b-41d4-a716-446655440011", {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.delete(
    "https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/3047983b-d798-4aff-8dd4-628cf1900703/todos/550e8400-e29b-41d4-a716-446655440011",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

{
  "success": true
}