Skip to content
Leadtime
English
Esc
navigateopen⌘Jpreview

List all task types

Returns a list of all task types configured in the workspace. Task types structure workflows, bundle fields and statuses, and define how tasks are created and handled. Each task type specifies what kind of ticket is created, what information must be collected, and how the processing workflow works. This endpoint is optimized for common list data retrieval and includes translations, associated statuses, custom fields, and required fields for each type.

Use this endpoint as metadata before POST /tasks. The global create-task schema cannot know which fields are required for every workspace/task-type configuration. For the selected typeId, inspect requiredFields and include those fields in the POST /tasks body. Standard fields such as summary and estimatedTime can be listed here, as well as task custom fields.

GET/tasks/types
Authorization
AuthorizationOAuth2 access token · headerrequired
Scopes:api:read
or
AuthorizationBearer token (JWT) · headerrequired
Query parameters
includeDeletedboolean
Include deleted task types in the response (default: true)
default: true
Responses
200Task types retrieved successfully
Array of TaskTypeDto
customFieldsstring[]required
Array of custom field UUIDs associated with this task type. These custom fields appear when creating or editing tasks of this type.
deletedbooleanrequired
Whether this task type has been soft-deleted. Deleted types are typically hidden from active use but retained for historical data.
iconstringrequired
Icon identifier in the format `:icon_name:` (e.g., `:rocket:`, `:bug:`, `:star:`). Used for visual representation in task lists and views.
idstringrequired
Unique identifier (UUID) for the task type
namestringrequired
Name of the task type (e.g., Bug, Feature, Support Request). Used for identification in the UI.
requiredFieldsstring[]required
Array of field names that are required when creating tasks of this type. This is contextual metadata for POST /tasks: fields listed here must be included even when the global create-task OpenAPI schema marks them optional. Common values include summary, estimatedTime, deadline, assignedToId, accountableId, and custom field names.
sortnumberrequired
Sort order for displaying task types in lists. Lower numbers appear first.
statusesstring[]required
Array of task status UUIDs that are valid for this task type. Defines the workflow states available for tasks of this type.
translationsTranslationDto[]required
Multilingual translations for the task type name. Supports displaying the type name in different languages based on user preferences.
Show properties
Array of TranslationDto
descriptionobject
Translated description
languagestringrequired
Language code (e.g., en, es, fr)
namestringrequired
Translated name
typestringrequired
Base type category: Feature (value-adding work) or Bug (bug fix, typically not billable)
Allowed:FeatureBug
401Unauthorized - Invalid or missing authentication token
403Forbidden - Insufficient API scopes or permissions
Request
curl -X GET "https://leadtime.app/api/public/tasks/types" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response
[
  {
    "customFields": [
      "string"
    ],
    "deleted": true,
    "icon": "string",
    "id": "string",
    "name": "string",
    "requiredFields": [
      "string"
    ],
    "sort": 0,
    "statuses": [
      "string"
    ],
    "translations": [
      {
        "description": {},
        "language": "string",
        "name": "string"
      }
    ],
    "type": "Feature"
  }
]