Answer a question in a project component item

Submits an answer to a question within a project component item. This endpoint allows users to provide answers to questions that capture customer requirements or project details.

Question Types and Answer Formats: Questions can have different types, and each type requires a specific answer format. Only provide the answer field(s) relevant to the question type:

ShortText: Provide shortTextAnswer (string)
Editor: Provide editorAnswer (HTML or Markdown string)
Checkbox: Provide selectedOptions (array of option IDs for multiple selections)
Radio: Provide selectedOption (single option ID string)
Files: Provide fileUrls (array of file URL strings)
Datepicker: Provide dateAnswer (ISO 8601 date string)
Multiplier: Provide multiplierAnswer (number)
Person: Provide selectedPersonId (array of person IDs)

Automatic Processing: When you submit an answer, the system automatically:

Tracks who answered (answeredBy is set to the current user)
Records when the answer was provided (answeredAt timestamp)
Calculates the isAnswered flag based on whether a valid answer was provided
Updates option selections for Checkbox/Radio types (marks options as selected)
Recalculates project conditions to show/hide dependent items based on the answer
Updates effort calculations if the question affects pricing (for Checkbox/Radio/Multiplier types)
Updates timeframes if effort changed

Permissions: This endpoint uses the processComponentsQuestions permission, which is more permissive than manageComponents. This allows users to answer questions and participate in project configuration without requiring full component edit access.

POST/projects/{projectId}/items/{itemId}/questions/{id}/answer

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

projectIdstringrequired

Project UUID

itemIdstringrequired

Component Item UUID

idstringrequired

Question UUID

Request body

requiredapplication/json

dateAnswerstring

Date answer for Datepicker question type (ISO 8601 format)

editorAnswerstring

Rich text answer for Editor question type (HTML or Markdown format)

fileUrlsstring[]

Array of file URLs for File question type

multiplierAnswernumber

Numeric multiplier answer for Number question type

selectedOptionstring

Single selected option ID for Radio question type

selectedOptionsstring[]

Array of selected option IDs for Checkbox question type (multiple selections)

selectedPersonIdstring[]

Array of person IDs for Person question type

shortTextAnswerstring

Short text answer for ShortText question type

Responses

200

Question answered successfully

400

Invalid request: invalid UUID format, invalid date format, or invalid option IDs

401

Unauthorized - Invalid or missing authentication token

403

Insufficient permissions (processComponentsQuestions) or access to project denied

404

Question not found or question does not belong to the component item in the project

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 UUID

Bodyapplication/json

Request body

Request

curl -X POST "https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/d47dc37b-7693-4d06-b49c-17084b773aff/questions/e57dc37b-7693-4d06-b49c-17084b773aff/answer" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "dateAnswer": "2024-12-31T00:00:00.000Z",
  "editorAnswer": "<p>This is a <strong>rich text</strong> answer</p>",
  "fileUrls": [
    "https://example.com/file1.pdf",
    "https://example.com/file2.jpg"
  ],
  "multiplierAnswer": 2.5,
  "selectedOption": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "selectedOptions": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "b2c3d4e5-f6g7-8901-bcde-f12345678901"
  ],
  "selectedPersonId": [
    "e57dc37b-7693-4d06-b49c-17084b773aff"
  ],
  "shortTextAnswer": "This is my answer"
}'

const response = await fetch("https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/d47dc37b-7693-4d06-b49c-17084b773aff/questions/e57dc37b-7693-4d06-b49c-17084b773aff/answer", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"dateAnswer\": \"2024-12-31T00:00:00.000Z\",\n  \"editorAnswer\": \"<p>This is a <strong>rich text</strong> answer</p>\",\n  \"fileUrls\": [\n    \"https://example.com/file1.pdf\",\n    \"https://example.com/file2.jpg\"\n  ],\n  \"multiplierAnswer\": 2.5,\n  \"selectedOption\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n  \"selectedOptions\": [\n    \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n    \"b2c3d4e5-f6g7-8901-bcde-f12345678901\"\n  ],\n  \"selectedPersonId\": [\n    \"e57dc37b-7693-4d06-b49c-17084b773aff\"\n  ],\n  \"shortTextAnswer\": \"This is my answer\"\n}"
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/items/d47dc37b-7693-4d06-b49c-17084b773aff/questions/e57dc37b-7693-4d06-b49c-17084b773aff/answer",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"dateAnswer\": \"2024-12-31T00:00:00.000Z\",\n  \"editorAnswer\": \"<p>This is a <strong>rich text</strong> answer</p>\",\n  \"fileUrls\": [\n    \"https://example.com/file1.pdf\",\n    \"https://example.com/file2.jpg\"\n  ],\n  \"multiplierAnswer\": 2.5,\n  \"selectedOption\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n  \"selectedOptions\": [\n    \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n    \"b2c3d4e5-f6g7-8901-bcde-f12345678901\"\n  ],\n  \"selectedPersonId\": [\n    \"e57dc37b-7693-4d06-b49c-17084b773aff\"\n  ],\n  \"shortTextAnswer\": \"This is my answer\"\n}",
)

Response

Question answered successfully