List all tags of specified type

Retrieves tags for the specified type in the workspace. Project documentation catalogs include active tags only; other tag types preserve their existing deletion-status behavior.

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.

• Project documentation tags: Used to label and filter documentation pages. They are workspace-level catalog entries that may be assigned only to documentation pages, not folders.

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

• Tag ID (UUID)
• Tag name
• Tag color (predefined color code, optional)
• Deletion status (always false for project documentation catalog results)

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
• Project documentation tags: Available to authenticated API readers; create, save, and delete require Projects.manageDocumentation permission

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"
    },
)

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