Partially update an existing question

Updates only the provided fields of an existing question for a component item within a project. Questions support multiple types (ShortText, Editor, Checkbox, Radio, Files, Datepicker, Multiplier, Person). For Checkbox/Radio types, options must be provided if type is being updated to one of these types. The description field accepts HTML or Markdown input and is stored in IDoc format. Options management: options with id are updated, options without id are created, options removed from array are deleted. Conditions management: conditions with id are updated, conditions without id are created, conditions removed from array are deleted. This endpoint automatically recalculates conditions, updates timeframes, and triggers summary generation.

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

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

projectIdstringrequired

Project UUID

itemIdstringrequired

Component item UUID

idstringrequired

Question 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

conditionsUpdateComponentItemConditionDto[]

Array of conditions that control question visibility/behavior (creates/updates/deletes based on presence of id)

Show properties

Array of UpdateComponentItemConditionDto

containsTypestring

Contains type for condition

Allowed:SomeAll

idstring

Condition ID - if provided, updates existing condition; if omitted, creates new condition

targetQuestionIdstring

Target question ID

targetTestCaseIdstring

Target test case ID

targetTodoIdstring

Target todo ID

targetValuestring

Target value to compare against

typestringrequired

Condition type

Allowed:QuestionAnsweredQuestionNotAnsweredQuestionAnswerContainsQuestionAnswerDoesNotContainQuestionAnswerEqualQuestionAnswerDoesNotEqualTodoIsDoneTodoIsNotDoneTestCasePassedTestCaseFailed

descriptionstring

Question description (accepts HTML or Markdown, returns HTML)

multiplierValuenumber

Multiplier value for calculations

optionsUpdateQuestionOptionDto[]

Array of answer options (creates/updates/deletes based on presence of id). Required if type is updated to Checkbox/Radio.

Show properties

Array of UpdateQuestionOptionDto

extraHoursnumber

Extra hours for this option

idstring

Option ID - if provided, updates existing option; if omitted, creates new option

titlestringrequired

Option title

questionstring

The question text

titlestring

Question title/heading

typestring

Question type

Allowed:ShortTextEditorCheckboxRadioFilesDatepickerMultiplierPerson

Responses

200

Question updated successfully

idstring

ID of the updated question

400

Invalid request: options array must have at least 1 item for Checkbox/Radio types when type is updated, or invalid UUID/description format

401

Unauthorized - Invalid or missing authentication token

403

Insufficient permissions to manage components or access to project denied

404

Project not found, item not found, question not found, or question does not belong to an item in the project

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 UUIDitemIdpath*Component item UUIDidpath*Question 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/e57dc37b-7693-4d06-b49c-17084b773aff/questions/f47dc37b-7693-4d06-b49c-17084b773baa" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "conditions": [
    {
      "containsType": "Some",
      "id": "e57dc37b-7693-4d06-b49c-17084b773aff",
      "targetQuestionId": "e57dc37b-7693-4d06-b49c-17084b773aff",
      "targetTestCaseId": "e57dc37b-7693-4d06-b49c-17084b773aff",
      "targetTodoId": "e57dc37b-7693-4d06-b49c-17084b773aff",
      "targetValue": "Yes",
      "type": "QuestionAnswered"
    }
  ],
  "description": "<p>This question helps us understand performance requirements.</p>",
  "multiplierValue": 1.5,
  "options": [
    {
      "extraHours": 2.5,
      "id": "e57dc37b-7693-4d06-b49c-17084b773aff",
      "title": "Option A"
    }
  ],
  "question": "Please specify the expected response time",
  "title": "What is the expected performance?",
  "type": "ShortText"
}'

const response = await fetch("https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/e57dc37b-7693-4d06-b49c-17084b773aff/questions/f47dc37b-7693-4d06-b49c-17084b773baa", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"conditions\": [\n    {\n      \"containsType\": \"Some\",\n      \"id\": \"e57dc37b-7693-4d06-b49c-17084b773aff\",\n      \"targetQuestionId\": \"e57dc37b-7693-4d06-b49c-17084b773aff\",\n      \"targetTestCaseId\": \"e57dc37b-7693-4d06-b49c-17084b773aff\",\n      \"targetTodoId\": \"e57dc37b-7693-4d06-b49c-17084b773aff\",\n      \"targetValue\": \"Yes\",\n      \"type\": \"QuestionAnswered\"\n    }\n  ],\n  \"description\": \"<p>This question helps us understand performance requirements.</p>\",\n  \"multiplierValue\": 1.5,\n  \"options\": [\n    {\n      \"extraHours\": 2.5,\n      \"id\": \"e57dc37b-7693-4d06-b49c-17084b773aff\",\n      \"title\": \"Option A\"\n    }\n  ],\n  \"question\": \"Please specify the expected response time\",\n  \"title\": \"What is the expected performance?\",\n  \"type\": \"ShortText\"\n}"
});

import requests

response = requests.patch(
    "https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/e57dc37b-7693-4d06-b49c-17084b773aff/questions/f47dc37b-7693-4d06-b49c-17084b773baa",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"conditions\": [\n    {\n      \"containsType\": \"Some\",\n      \"id\": \"e57dc37b-7693-4d06-b49c-17084b773aff\",\n      \"targetQuestionId\": \"e57dc37b-7693-4d06-b49c-17084b773aff\",\n      \"targetTestCaseId\": \"e57dc37b-7693-4d06-b49c-17084b773aff\",\n      \"targetTodoId\": \"e57dc37b-7693-4d06-b49c-17084b773aff\",\n      \"targetValue\": \"Yes\",\n      \"type\": \"QuestionAnswered\"\n    }\n  ],\n  \"description\": \"<p>This question helps us understand performance requirements.</p>\",\n  \"multiplierValue\": 1.5,\n  \"options\": [\n    {\n      \"extraHours\": 2.5,\n      \"id\": \"e57dc37b-7693-4d06-b49c-17084b773aff\",\n      \"title\": \"Option A\"\n    }\n  ],\n  \"question\": \"Please specify the expected response time\",\n  \"title\": \"What is the expected performance?\",\n  \"type\": \"ShortText\"\n}",
)

Response

{
  "id": "f47dc37b-7693-4d06-b49c-17084b773baa"
}