Create or update a question for a library component item

Creates a new question for a component library item or updates an existing question if id is provided in the request body.

What are Questions? Questions capture customer-specific requirements or project details in a structured way. They make work packages flexible and reusable by allowing later individualization in projects.

Question Types:

ShortText: Single-line text input (name, title, keyword)
Editor: Formatted multi-line text (descriptions, free text)
Checkbox: Yes/No selection (can impact effort calculation)
Radio: Single choice from multiple options (can impact effort)
Files: Upload files (logos, documents, graphics)
Datepicker: Select a date (deadlines, delivery dates)
Multiplier: Dynamic calculation based on quantity (e.g., “How many pages?” × duration per page = total effort)
Person: Select person(s) from project team or clients

Key Features:

Answers can automatically affect effort calculation
Questions can have conditions (shown only if other questions answered a certain way)
Multiplier questions calculate: Answer × Duration per element = Total additional effort
In library components, questions are defined but not answered

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

POST/administration/project-components/item-details/{itemId}/questions

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

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)

idstring

Question ID (for updates - if provided, updates existing question)

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, must have at least one option). Each option can have an extraHours value that affects effort calculation when selected.

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.

questionstringrequired

The question text that will be displayed to users. This is the actual question being asked (e.g., "Please specify the expected response time").

titlestringrequired

Question title/heading. Questions capture customer-specific requirements or project details. They make work packages flexible and reusable by allowing later individualization in projects.

typestringrequired

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 created or updated successfully

idstring

successboolean

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

itemIdpath*Component item UUID. Items are the building blocks within components (Epics, Work Packages, Todo Lists, Test Suites).

Bodyapplication/json

Request body

Request

curl -X POST "https://leadtime.app/api/public/administration/project-components/item-details/3047983b-d798-4aff-8dd4-628cf1900703/questions" \
  -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>",
  "id": "e57dc37b-7693-4d06-b49c-17084b773aff",
  "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", {
  method: "POST",
  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  \"id\": \"e57dc37b-7693-4d06-b49c-17084b773aff\",\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.post(
    "https://leadtime.app/api/public/administration/project-components/item-details/3047983b-d798-4aff-8dd4-628cf1900703/questions",
    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  \"id\": \"e57dc37b-7693-4d06-b49c-17084b773aff\",\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": "e57dc37b-7693-4d06-b49c-17084b773aff",
  "success": true
}