Toggle todo completion status

Toggles the completion status of a todo item within a project component item. Updates the isDone status, sets doneBy to the current user, and updates doneUpdatedAt timestamp. This endpoint uses the processComponentsTodos permission, allowing users to toggle todo completion without requiring full component management permissions. After toggling, the system recalculates conditions and marks the project configuration as changed.

POST/projects/{projectId}/items/{itemId}/todos/{id}/toggle

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

projectIdstringrequired

Project UUID

itemIdstringrequired

Component item UUID (the item that contains the todo)

idstringrequired

Todo UUID

Request body

requiredapplication/json

isDonebooleanrequired

Whether the todo should be marked as done (true) or not done (false)

Responses

200

Todo completion status toggled successfully

successboolean

400

Invalid UUID format or missing isDone field

401

Unauthorized - Invalid or missing authentication token

403

Insufficient permissions or no access to project

404

Todo not found or does not belong to a component item in the specified 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 (the item that contains the todo)idpath*Todo UUID

Bodyapplication/json

isDoneboolean*Whether the todo should be marked as done (true) or not done (false)

Request

curl -X POST "https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/b58dc37b-7693-4d06-b49c-17084b773aff/todos/c69dc37b-7693-4d06-b49c-17084b773aff/toggle" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "isDone": true
}'

const response = await fetch("https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/b58dc37b-7693-4d06-b49c-17084b773aff/todos/c69dc37b-7693-4d06-b49c-17084b773aff/toggle", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"isDone\": true\n}"
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/b58dc37b-7693-4d06-b49c-17084b773aff/todos/c69dc37b-7693-4d06-b49c-17084b773aff/toggle",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"isDone\": true\n}",
)

Response

{
  "success": true
}