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

200

Todo deleted successfully

successboolean

400

Invalid projectId, itemId, or todo id format

401

Unauthorized - Invalid or missing authentication token

403

Insufficient permissions to manage components or no access to project

404

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

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

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

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
}