---
search:
  tags:
    - administration
    - POST
seo:
  description: >-
    Creates a new component item within a library… Reference for the POST
    /administration/project-components/items endpoint in the Leadtime Public API
    API.
sidebar:
  badge: POST
  label: Create a new component item (Epic, Work Package, Todo List, or Test Suite)
title: Create a new component item (Epic, Work Package, Todo List, or Test Suite)
type: openapi-operation
---
Creates a new component item within a library component. Items are the building blocks that structure component templates.

**What are Component Items?**
Items are the building blocks within components that organize and structure project work. Each item can be one of four types:

1. **Epic**: Major sections or phases that group related work packages around a common theme or goal
   - Example: "Technical Implementation", "Design & Development", "Project Kickoff & Preparation"
   - Can contain Work Packages, Todo Lists, or Test Suites
   - Can nest other Epics to create complex hierarchies (arbitrary nesting depth)
   - TimeFrame is not required for Epics

2. **Work Package**: Self-contained, clearly defined tasks that deliver tangible results
   - Example: "Set up domain and hosting", "Design homepage layout", "Configure CMS"
   - Can have timeframes/estimates (required field)
   - Can contain Questions (to capture customer requirements), Todos (checklist items), and Test Cases (acceptance test steps)
   - Can nest other Work Packages for complex tasks

3. **Todo List**: Checklists of sub-steps or checkpoints
   - Example: "Kickoff Checklist", "Quality Control Checklist", "Go-live Approval"
   - Perfect for recurring processes (tests, approvals, installation steps)
   - Each todo item within the list can be checked off individually
   - TimeFrame is required

4. **Test Suite**: Formal acceptance tests for project results
   - Example: "Contact Form Tests", "Responsive Design Check", "SEO Review"
   - Contains multiple test cases with steps and expected results
   - TimeFrame is required

**Item Placement:**
Items can be created at the root level of a component or nested under parent items (Epics or other Work Packages).

**Content Format:**
The description and internalNote fields accept HTML or Markdown input and are automatically converted to the internal IDoc format for storage.

**Validation Rules:**
TimeFrame is required for all item types except Epic. Only library component items (component.projectId is null) can be created through this endpoint.

<Operation source="api-reference" id="componentlibrarycontroller-createitem" />