Get task types

Retrieves all task types configured for the workspace.

What are task types? Task types are the backbone of task organization in Leadtime. They define what kind of tickets exist in the system (e.g., Feature, Bug, Support Case) and structure how tasks are created, documented, and handled.

What a task type includes:

• Icon and name: Recognizable symbol and name (e.g., “Server Crash”, “Feature Request”)
• Base type: Feature (value-adding work) or Bug (bug fix, typically not billable)
• Status options: Which statuses can be used in this task type workflow
• Custom fields: Additional structured data fields beyond standard fields
• Work activities: Which time tracking activities are allowed
• Task template: Pre-filled description structure for new tasks
• Required fields: Fields that must be filled when creating tasks of this type

Benefits:

• Structure workflows with unified statuses and fields
• Ensure complete data capture with required fields
• Enable precise analysis and reporting
• Customize for different departments or teams

What is returned: An array of task type objects, each containing:

• Type identification (ID, name, icon, base type)
• Sort order for display
• Multilingual translations
• Associated status IDs
• Associated custom field IDs
• Associated work activity IDs
• Task template as HTML
• Required field names

Note: Task templates are returned as HTML, converted from the internal IDoc format.

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

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

import requests

response = requests.get(
    "https://leadtime.app/api/public/administration/task-settings/types",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

[
  {
    "customFields": [
      "field-1",
      "field-2"
    ],
    "icon": ":rocket:",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Feature",
    "requiredFields": [
      "title",
      "description",
      "summary",
      "estimatedTime"
    ],
    "sort": 1,
    "statuses": [
      "status-1",
      "status-2"
    ],
    "templateDoc": "<h1>Task Template</h1><p>This is a template for new tasks of this type.</p>",
    "translations": [
      {
        "language": "en",
        "name": "Feature"
      },
      {
        "language": "de",
        "name": "Funktion"
      }
    ],
    "type": "Feature"
  }
]