Skip to content
Leadtime
English
EnglishDeutschNot translated
Esc
↑↓navigate↵open⌘Jpreview

Get task details by UUID or shortNumber

Returns complete task details including all metadata, description, comments, history, time logs, participants, subtasks, and custom fields. The description and comment bodies are returned in HTML format (converted from the internal editor format). Accepts both UUID (id) and numeric shortNumber identifiers. Access is controlled by project permissions and guest access settings. Organization members can only access tasks with guestAccess enabled.

Embedded images and files in HTML: Rich text may contain <div data-type="appImage">, <div data-type="appFile">, or <div data-type="appVideo"> nodes with a fileId attribute (UUID) and filename. Images are not inlined as base64 in this API response.

Downloading embedded binaries for display or AI vision: Use authenticated HTTP GET on the Public API endpoint /workspace/files/{fileId}, sending the same Bearer token. Integrations and agents should parse fileId from the HTML, then fetch it only when they need the binary content. Plain /api/files/public/... is reserved for explicitly public or signed-capability assets.

GET/tasks/{identifier}
Authorization
AuthorizationOAuth2 access token · headerrequired
Scopes:api:read
or
AuthorizationBearer token (JWT) · headerrequired
Path parameters
identifierstringrequired
Task UUID or numeric shortNumber
Responses
200Task details retrieved successfully
accountableobject
Accountable user details
accountableIdstring
Accountable user ID
assignedToobject
Assigned user details
assignedToIdstring
Assigned user ID
billedbooleanrequired
Whether task is billed
childSpentTimenumberrequired
Child tasks spent time in minutes
commentsany[][]required
Task comments; each `body` is HTML and may contain the same embedded `appImage` / `appFile` / `appVideo` divs with `fileId` as the task description. Fetch binaries via authenticated `/api/public/workspace/files/{fileId}` with the same Public API Bearer token when needed.
componentItemIdobject
Component item ID
createdAtstring<date-time>required
Task creation timestamp
customFieldsobjectrequired
Custom fields values
deadlinestring<date-time>
Task deadline
descriptionstringrequired
Task description in HTML. May include embedded assets as elements such as `<div data-type="appImage" fileId="…" filename="…">` (images), `appFile`, or `appVideo`—binary content is not embedded; use authenticated GET `{appOrigin}/api/public/workspace/files/{fileId}` with the same Public API Bearer token to retrieve it.
emailDetailsobject
Email details
emailSendErrorstring
Email send error message
emailSendErrorCodestring
Email send error code
emailSendFailedAtstring<date-time>
Email send failed timestamp
emailSendFailedToany[][]
Email send failed recipients
enableSupportContingentbooleanrequired
Enable support contingent
estimatedTimenumber
Estimated time in hours
guestAccessbooleanrequired
Guest access enabled for organization members
historyany[][]required
Task history entries
iconobject
Task icon identifier in the format `:icon_name:` (e.g., `:rocket:`, `:bug:`, `:memo:`). Can be null if no custom icon is set.
iconIsGeneratingbooleanrequired
Whether icon is being generated by AI
idstringrequired
Task ID (UUID)
isChangeRequestbooleanrequired
Whether task is a change request
isParticipantbooleanrequired
Whether current user is a participant
notificationSettingsobjectrequired
Notification settings
parentTaskIdobject
Parent task ID for subtasks
participantsCountnumberrequired
Number of participants
participantsListany[][]required
List of participant user IDs
priorityobjectrequired
Task priority (TaskPriority enum)
productsany[][]required
Task products
projectobjectrequired
Project information
projectIdstringrequired
Project ID
quotationsany[][]required
Express quotations
shortNumbernumberrequired
Task short number (workspace-scoped)
skipFromBillingboolean
Skip from billing
spentTimenumberrequired
Total spent time in minutes
statusIdstringrequired
Task status ID
subTasksIdsany[][]required
Child task IDs
summarystring
Task summary
summaryIsGeneratingbooleanrequired
Whether summary is being generated by AI
tagsany[][]required
Task tags
titlestringrequired
Task title
titleIsGeneratingbooleanrequired
Whether title is being generated by AI
typeIdstringrequired
Task type ID
userIdstringrequired
Creator user ID
400Invalid identifier format (not UUID and not numeric)
401Unauthorized - Invalid or missing authentication token
403Forbidden - Insufficient API scopes or permissions
404Task not found
Request
curl -X GET "https://leadtime.app/api/public/tasks/550e8400-e29b-41d4-a716-446655440000%20or%20123" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response
{
  "accountable": {},
  "accountableId": "string",
  "assignedTo": {},
  "assignedToId": "string",
  "billed": true,
  "childSpentTime": 0,
  "comments": [
    [
      null
    ]
  ],
  "componentItemId": {},
  "createdAt": "2024-01-01T00:00:00Z",
  "customFields": {},
  "deadline": "2024-01-01T00:00:00Z",
  "description": "string",
  "emailDetails": {},
  "emailSendError": "string",
  "emailSendErrorCode": "string",
  "emailSendFailedAt": "2024-01-01T00:00:00Z",
  "emailSendFailedTo": [
    [
      null
    ]
  ],
  "enableSupportContingent": true,
  "estimatedTime": 0,
  "guestAccess": true,
  "history": [
    [
      null
    ]
  ],
  "icon": {},
  "iconIsGenerating": true,
  "id": "string",
  "isChangeRequest": true,
  "isParticipant": true,
  "notificationSettings": {},
  "parentTaskId": {},
  "participantsCount": 0,
  "participantsList": [
    [
      null
    ]
  ],
  "priority": {},
  "products": [
    [
      null
    ]
  ],
  "project": {},
  "projectId": "string",
  "quotations": [
    [
      null
    ]
  ],
  "shortNumber": 0,
  "skipFromBilling": true,
  "spentTime": 0,
  "statusId": "string",
  "subTasksIds": [
    [
      null
    ]
  ],
  "summary": "string",
  "summaryIsGenerating": true,
  "tags": [
    [
      null
    ]
  ],
  "title": "string",
  "titleIsGenerating": true,
  "typeId": "string",
  "userId": "string"
}