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

AuthorizationBearer token (JWT) · headerrequired

Query parameters

includeDeletedboolean

Include deleted task types in the response (default: true)

default: true

Responses

200

Task 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

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

includeDeletedqueryInclude deleted task types in the response (default: true)

Request

curl -X GET "https://leadtime.app/api/public/tasks/types" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/tasks/types", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://leadtime.app/api/public/tasks/types",
    headers={
        "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"
  }
]