Get task custom fields

Retrieves all custom fields configured for tasks in the workspace.

What are custom fields? Custom fields allow you to capture structured, project-specific data beyond standard task fields. They help organize information systematically and make data more consistent, reports more meaningful, and processes easier to automate.

Common use cases:

• Priority levels by customer group or contract type
• Reference numbers from external systems
• Technical parameters or version details
• Checkboxes for internal approvals
• Dropdowns for classifications, responsibilities, or error categories

What is returned: An array of custom field objects, each containing:

• Field identification (ID, name, description)
• Field type (Text, TextArea, Number, Date, Checkbox, Select, MultiSelect)
• Sort order for display
• Multilingual translations for field name and description
• Select options (for Select and MultiSelect types) with their own translations

Note: Custom fields are assigned to specific task types and appear in the task form when creating or editing tasks of those types.

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

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

import requests

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

[
  {
    "description": "Task priority level",
    "entity": "Task",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Priority",
    "selectOptions": [
      {
        "id": "1",
        "translations": [
          {
            "language": "en",
            "name": "Priority"
          }
        ],
        "value": "High"
      }
    ],
    "sort": 1,
    "translations": [
      {
        "language": "en",
        "name": "Priority"
      }
    ],
    "type": "Select"
  }
]