List all tags of specified type

Retrieves all tags for the specified type (task, project, or project-component) in the workspace.

What are Tags? Tags in Leadtime enable cross-project organization, visual marking, and filtering of tasks, projects, and project components by topics or processes. They help you link related work across different projects and quickly find all entries with a specific tag.

Tag Types:

Task tags: Used to label and organize individual tasks/tickets across all projects
Project tags: Used to categorize and organize entire projects
Project component tags: Used in project component library to label work packages, checklists, and test suites. These tags are automatically inherited by all elements underneath (cascading tags), making it easy to organize tasks that belong together.

What is returned: Returns an array of tag objects, each containing:

Tag ID (UUID)
Tag name
Tag color (predefined color code, optional)
Deletion status (soft-deleted tags are marked but not removed)

Permission requirements:

Task tags: No permission required (accessible to all authenticated users)
Project tags: No permission required (accessible to all authenticated users)
Project component tags: Requires ProjectComponentsLibrary.view OR Projects.manageComponents permission

GET/tags/{type}/list

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Path parameters

typestringrequired

The type of tags to work with. Determines which tag category you are accessing: - "task": Tags for individual tasks/tickets across all projects - "project": Tags for categorizing entire projects - "project-component": Tags used in project component library (with cascading inheritance) - "organization": Tags for categorizing organizations - "object": Tags for workspace object instances - "form-template": Tags for workspace form templates (administration)

Allowed:taskprojectproject-componentorganizationobjectform-template

Responses

200

Array of TagResponseDto

colorstring | nullrequired

The predefined color code assigned to the tag for visual organization. Null if no color has been set. Colors help users quickly identify tags in lists and cards. **Available color values:** - `default` - Light gray (default color) - `red` - Red - `yellow` - Yellow - `green` - Green - `blue` - Blue - `purple` - Purple - `fuchsia` - Fuchsia - `pink` - Pink - `magenta` - Magenta

Allowed:defaultredyellowgreenbluepurplefuchsiapinkmagentanull

idstringrequired

The unique identifier (UUID) of the tag. Use this ID when updating or deleting the tag.

isDeletedbooleanrequired

Indicates whether the tag has been soft-deleted. Soft-deleted tags are marked as deleted but not permanently removed from the database. They will not appear in list endpoints and are automatically removed from all associated entities.

namestringrequired

The display name of the tag. This is what users see when the tag is applied to tasks, projects, or components.

400Invalid tag type

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

curl -X GET "https://leadtime.app/api/public/tags/task/list" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

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

import requests

response = requests.get(
    "https://leadtime.app/api/public/tags/task/list",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

[
  {
    "color": "blue",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "isDeleted": false,
    "name": "urgent"
  }
]