> ## Documentation Index
> Fetch the complete documentation index at: https://docs.larm.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Create component

> Adds a component to a status page

Requires `status_pages:read_write` permission.

**status\_page\_id** `string` *required*

Status page UUID

**name** `string` *required*

Component name (1–255 characters)

**position** `integer` *required*

Display position (0-indexed)

**description** `string`

Optional description

**component\_group\_id** `string`

Optional group UUID to organize components under a heading

**monitors** `object[]`

Monitors to link. Each object has `monitor_id` (monitor UUID) and `down_status` (`major_outage`, `partial_outage`, or `degraded_performance`). Linked monitors trigger auto-disruptions when they detect failures.

```json 201 theme={null}
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "API",
    "description": "REST API endpoints",
    "position": 0,
    "component_group_id": null,
    "monitors": [
      {
        "monitor_id": "660e8400-e29b-41d4-a716-446655440000",
        "down_status": "major_outage"
      }
    ],
    "inserted_at": "2026-03-28T12:00:00Z",
    "updated_at": "2026-03-28T12:00:00Z"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.