Partially update a question for a library component item

Updates specific fields of an existing question. Only provided fields will be updated.

What are Questions? Questions capture customer-specific requirements or project details. They can have different types (ShortText, Editor, Checkbox, Radio, Files, Datepicker, Multiplier, Person) and can affect effort calculation.

For Checkbox/Radio types, if options are provided, at least one option must be included. Description field accepts HTML or Markdown input and returns HTML format. Only library component item questions (component.projectId is null) are accessible through this endpoint.

PATCH/administration/project-components/item-details/{itemId}/questions/{questionId}

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).

questionIdstringrequired

Question UUID

Request body

requiredapplication/json

conditionsQuestionConditionDto[]

Question conditions that control visibility/behavior. Conditions can show/hide questions based on answers to other questions, todo completion, or test case status.

Show properties

Array of QuestionConditionDto

containsTypestring

Contains type

Allowed:SomeAll

idstring

Condition ID (for updates)

targetQuestionIdstring

Target question ID

targetTestCaseIdstring

Target test case ID

targetTodoIdstring

Target todo ID

targetValuestring

Target value

typestringrequired

Condition type. Conditions control when items or questions are visible/active: - **QuestionAnswered/QuestionNotAnswered**: Based on whether a question is answered - **QuestionAnswerEqual/QuestionAnswerDoesNotEqual**: Based on specific answer value - **QuestionAnswerContains/QuestionAnswerDoesNotContain**: Based on answer containing values - **TodoIsDone/TodoIsNotDone**: Based on todo completion status - **TestCasePassed/TestCaseFailed**: Based on test case evaluation

Allowed:QuestionAnsweredQuestionNotAnsweredQuestionAnswerContainsQuestionAnswerDoesNotContainQuestionAnswerEqualQuestionAnswerDoesNotEqualTodoIsDoneTodoIsNotDoneTestCasePassedTestCaseFailed

descriptionstring

Question description (accepts HTML or Markdown, returns HTML)

multiplierValuenumber

Multiplier value (for Multiplier type). This is the duration per element (e.g., hours per page). When answered, the system calculates: Answer × multiplierValue = Total additional effort.

optionsQuestionOptionDto[]

Question options (required for Checkbox/Radio types)

Show properties

Array of QuestionOptionDto

extraHoursnumber

Extra hours for this option. When this option is selected (for Checkbox/Radio questions), this value is added to the effort calculation.

idstring

Option ID (for updates)

titlestringrequired

Option title. For Checkbox questions, users can select multiple options. For Radio questions, users can select only one option.

questionstring

The question text that will be displayed to users.

titlestring

Question title/heading. Questions capture customer-specific requirements or project details.

typestring

Question type. Questions can be: - **ShortText**: Single-line text input - **Editor**: Formatted multi-line text - **Checkbox**: Yes/No selection (can impact effort) - **Radio**: Single choice from options (can impact effort) - **Files**: Upload files - **Datepicker**: Select a date - **Multiplier**: Dynamic calculation (quantity × duration per element) - **Person**: Select person(s) from team

Allowed:ShortTextEditorCheckboxRadioFilesDatepickerMultiplierPerson

Responses

200Question updated successfully

successboolean

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

curl -X PATCH "https://leadtime.app/api/public/administration/project-components/item-details/3047983b-d798-4aff-8dd4-628cf1900703/questions/e57dc37b-7693-4d06-b49c-17084b773aff" \
  -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/administration/project-components/item-details/3047983b-d798-4aff-8dd4-628cf1900703/questions/e57dc37b-7693-4d06-b49c-17084b773aff", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "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"
})
});

import requests

response = requests.patch(
    "https://leadtime.app/api/public/administration/project-components/item-details/3047983b-d798-4aff-8dd4-628cf1900703/questions/e57dc37b-7693-4d06-b49c-17084b773aff",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "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"
},
)

Response

{
  "success": true
}