Partially update a component item

Updates only the provided fields of an existing component item (epic, feature, task) in a project. The description and internalNote fields accept HTML or Markdown and will be converted to the internal format. When the conditions array is provided, it completely replaces existing conditions. Conditions with id are updated, conditions without id are created, and conditions not in the array are deleted. Updating an item triggers automatic side effects including condition recalculation, project configuration change tracking, and timeframe updates.

PATCH/projects/{projectId}/items/{id}

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

projectIdstringrequired

Project UUID

idstringrequired

Component item UUID

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

componentIdstring

ID of the component this item belongs to

conditionsPatchComponentItemConditionDto[]

Array of conditions (full array replaces existing conditions)

Show properties

Array of PatchComponentItemConditionDto

containsTypestring

Contains type for condition

Allowed:SomeAll

idstring

Condition ID for updates. If not provided, creates new condition

targetQuestionIdstring

Target question ID

targetTestCaseIdstring

Target test case ID

targetTodoIdstring

Target todo ID

targetValuestring

Target value for condition

typestring

Condition type. Required if creating new condition

Allowed:QuestionAnsweredQuestionNotAnsweredQuestionAnswerContainsQuestionAnswerDoesNotContainQuestionAnswerEqualQuestionAnswerDoesNotEqualTodoIsDoneTodoIsNotDoneTestCasePassedTestCaseFailed

descriptionstring

Description in HTML or Markdown format (will be converted to IDoc if provided)

iconobject | null

Icon identifier (can be set to null)

includeInSpecificationboolean

Whether to include in specification

internalNotestring

Internal note in HTML or Markdown format (will be converted to IDoc if provided)

namestring

Name of the item

parentIdstring

ID of parent item for nested items

tagsstring[]

Array of tag UUIDs

timeFramenumber

Time frame in hours. Required for all types except Epic (when type is provided)

typestring

Type of item (Epic, Feature, Task, etc.)

Allowed:EpicWorkPackageTodoListTestSuite

Responses

200

Item updated successfully

idstring<uuid>

400

Invalid request: invalid UUID format for item ID, project ID, component ID, tag IDs, or invalid type/timeFrame combination

401

Unauthorized - Invalid or missing authentication token

403

Insufficient permissions to manage components or access to project denied

404

Item not found, item does not belong to project component, component not found, or parent item not found

422

Editor content conversion errors

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 UUIDidpath*Component item UUIDfieldsToReturnqueryComma-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

Request body

Request

curl -X PATCH "https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/3047983b-d798-4aff-8dd4-628cf1900703" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "componentId": "550e8400-e29b-41d4-a716-446655440000",
  "conditions": [
    {
      "containsType": "Some",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "targetQuestionId": "550e8400-e29b-41d4-a716-446655440000",
      "targetTestCaseId": "550e8400-e29b-41d4-a716-446655440000",
      "targetTodoId": "550e8400-e29b-41d4-a716-446655440000",
      "targetValue": "Yes",
      "type": "QuestionAnswered"
    }
  ],
  "description": "<p>Implement user authentication and authorization</p>",
  "icon": "🔐",
  "includeInSpecification": true,
  "internalNote": "<p>Implementation notes for the development team</p>",
  "name": "User Authentication Feature",
  "parentId": "550e8400-e29b-41d4-a716-446655440000",
  "tags": [
    "550e8400-e29b-41d4-a716-446655440000"
  ],
  "timeFrame": 40,
  "type": "WorkPackage"
}'

const response = await fetch("https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/3047983b-d798-4aff-8dd4-628cf1900703", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"componentId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"conditions\": [\n    {\n      \"containsType\": \"Some\",\n      \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n      \"targetQuestionId\": \"550e8400-e29b-41d4-a716-446655440000\",\n      \"targetTestCaseId\": \"550e8400-e29b-41d4-a716-446655440000\",\n      \"targetTodoId\": \"550e8400-e29b-41d4-a716-446655440000\",\n      \"targetValue\": \"Yes\",\n      \"type\": \"QuestionAnswered\"\n    }\n  ],\n  \"description\": \"<p>Implement user authentication and authorization</p>\",\n  \"icon\": \"🔐\",\n  \"includeInSpecification\": true,\n  \"internalNote\": \"<p>Implementation notes for the development team</p>\",\n  \"name\": \"User Authentication Feature\",\n  \"parentId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"tags\": [\n    \"550e8400-e29b-41d4-a716-446655440000\"\n  ],\n  \"timeFrame\": 40,\n  \"type\": \"WorkPackage\"\n}"
});

import requests

response = requests.patch(
    "https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/3047983b-d798-4aff-8dd4-628cf1900703",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"componentId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"conditions\": [\n    {\n      \"containsType\": \"Some\",\n      \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n      \"targetQuestionId\": \"550e8400-e29b-41d4-a716-446655440000\",\n      \"targetTestCaseId\": \"550e8400-e29b-41d4-a716-446655440000\",\n      \"targetTodoId\": \"550e8400-e29b-41d4-a716-446655440000\",\n      \"targetValue\": \"Yes\",\n      \"type\": \"QuestionAnswered\"\n    }\n  ],\n  \"description\": \"<p>Implement user authentication and authorization</p>\",\n  \"icon\": \"🔐\",\n  \"includeInSpecification\": true,\n  \"internalNote\": \"<p>Implementation notes for the development team</p>\",\n  \"name\": \"User Authentication Feature\",\n  \"parentId\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"tags\": [\n    \"550e8400-e29b-41d4-a716-446655440000\"\n  ],\n  \"timeFrame\": 40,\n  \"type\": \"WorkPackage\"\n}",
)

Response

{
  "id": "3047983b-d798-4aff-8dd4-628cf1900703"
}