Create a new todo (checklist item) for a library component item

Creates a new todo checklist item for a library component item.

What are Todos? Todos are checklist items used to track actionable tasks within component items. They are perfect for:

Recurring processes (tests, approvals, installation steps)
Quality control checkpoints
Project preparation steps
Final checks before go-live

Each todo can be checked off individually, supports comments, and tracks completion status. Todos can be attached to Work Packages or Todo List items.

Description accepts HTML or Markdown format and is converted to IDoc for storage. Only library component items (component.projectId is null) are accessible.

POST/administration/project-components/item-details/{itemId}/todos

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

itemIdstringrequired

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

Query parameters

fieldsToReturnstring

Comma-separated list of top-level response fields to return. Overrides the endpoint compact default unless responseShape=full is used.

responseShapestring

Advanced override. Omit for the endpoint compact default. Use full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.

Allowed:compactfull

Header parameters

LT-Response-Shapestring

Advanced override. Set to full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.

Allowed:full

Request body

requiredapplication/json

descriptionstringrequired

Todo description in HTML or Markdown format

titlestringrequired

Todo title

Responses

201

idstring

ID of the updated todo

successbooleanrequired

Operation success status

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

itemIdpath*Component item UUID. Items are the building blocks within components (Epics, Work Packages, Todo Lists, Test Suites).fieldsToReturnqueryComma-separated list of top-level response fields to return. Overrides the endpoint compact default unless responseShape=full is used.responseShapequeryAdvanced override. Omit for the endpoint compact default. Use full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.LT-Response-ShapeheaderAdvanced override. Set to full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.

Bodyapplication/json

descriptionstring*Todo description in HTML or Markdown formattitlestring*Todo title

Request

curl -X POST "https://leadtime.app/api/public/administration/project-components/item-details/3047983b-d798-4aff-8dd4-628cf1900703/todos" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "description": "<p>Add user login functionality</p>",
  "title": "Implement authentication"
}'

const response = await fetch("https://leadtime.app/api/public/administration/project-components/item-details/3047983b-d798-4aff-8dd4-628cf1900703/todos", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"description\": \"<p>Add user login functionality</p>\",\n  \"title\": \"Implement authentication\"\n}"
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/administration/project-components/item-details/3047983b-d798-4aff-8dd4-628cf1900703/todos",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"description\": \"<p>Add user login functionality</p>\",\n  \"title\": \"Implement authentication\"\n}",
)

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "success": true
}