Get component library tree structure

Returns the complete hierarchical tree structure of the component library, including all components and their items.

What is the Component Library? The component library is a workspace-wide catalog of reusable component templates. These templates can be imported into projects to standardize recurring project types.

Library Components vs Project Components:

Library Components (this endpoint): Workspace-wide templates (projectId is null) - reusable blueprints with no live data
Project Components: Live instances in projects (projectId is set) - contain answers, evaluations, and can be connected to tasks

Component Structure:

Components: Top-level containers (e.g., “Website Development”, “CRM Onboarding”)
Items: Can be Epics, Work Packages, Todo Lists, or Test Suites
Items can be nested to any depth

This endpoint provides read-only access to the workspace component library for programmatic access.

GET/administration/project-components/library-tree

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:read

AuthorizationBearer token (JWT) · headerrequired

Responses

200

componentsComponentTreeComponentDto[]required

List of components in the library

Show properties

Array of ComponentTreeComponentDto

iconobject | nullrequired

Icon identifier for the component (nullable). Format: :icon_name: (e.g., :rocket:, :box:, :star:)

idstringrequired

Unique identifier for the component

namestringrequired

Name of the component

totalTimeFramenumberrequired

Total time frame for the component

itemsComponentTreeItemDto[]required

List of items (Epics, Work Packages, Todo Lists, Test Suites) in the library. Items are the building blocks within components and can be nested to any depth.

Show properties

Array of ComponentTreeItemDto

componentIdstringrequired

ID of the parent component

conditionsValidbooleanrequired

Whether all conditions are valid for this item

failedConditionsIdsstring[]required

Array of failed condition IDs

iconobject | nullrequired

Icon identifier for the component item (nullable). Format: :icon_name: (e.g., :rocket:, :check:, :star:)

idstringrequired

Unique identifier for the component item

namestringrequired

Name of the component item

parentIdobject | nullrequired

ID of the parent item (nullable for top-level items)

totalEstimatenumberrequired

Total time estimate for the item

typestringrequired

Type of the component item. Items are the building blocks within components: - **Epic**: Groups related work packages around a common theme - **WorkPackage**: Self-contained task that delivers a tangible result - **TodoList**: Checklist of sub-steps or checkpoints - **TestSuite**: Formal acceptance tests with test cases

Allowed:EpicWorkPackageTodoListTestSuite

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

curl -X GET "https://leadtime.app/api/public/administration/project-components/library-tree" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

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

import requests

response = requests.get(
    "https://leadtime.app/api/public/administration/project-components/library-tree",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

{
  "components": [
    {
      "icon": ":box:",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "User Authentication Module",
      "totalTimeFrame": 40
    }
  ],
  "items": [
    {
      "componentId": "550e8400-e29b-41d4-a716-446655440000",
      "conditionsValid": true,
      "failedConditionsIds": [],
      "icon": ":check:",
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "name": "Login Feature",
      "parentId": null,
      "totalEstimate": 20,
      "type": "Epic"
    }
  ]
}