Skip to content
Leadtime
English
Esc
↑↓navigate↵open⌘Jpreview

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
or
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
401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it
Server
Authorization
Request
curl -X GET "https://leadtime.app/api/public/administration/project-components/library-tree" \
  -H "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"
    }
  ]
}