Zum Inhalt springen
Leadtime
Deutsch
EnglishDeutschNicht übersetzt
Esc
↑↓navigieren↵öffnen⌘Jvorschau

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
or
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
200

Question updated successfully

successboolean
401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it
Server
Authorization
Parameters
Bodyapplication/json
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"
}'
Response
{
  "success": true
}