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

# Manage components

Add or remove components from a status page, each optionally linked to a monitor for auto-status.

# Components

Status pages are made up of components. Each component can be linked to a monitor so its state (`operational`, `degraded`, `down`) updates automatically from live checks.

**Auth:** Bearer token (`write` scope)

## Add a component

POST `/status-pages/:id/components`

### Body parameters

Component name.

Component description.

Link to a monitor — status is derived automatically from the monitor's state.

### Request

```bash
curl -X POST -H "Authorization: Bearer hu_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Web App",
    "monitor_id": "mon_abc123"
  }' \
  "https://happyuptime.com/api/v1/status-pages/sp_001/components"
```

### Response

```json
{
  "data": {
    "id": "comp_003",
    "status_page_id": "sp_001",
    "name": "Web App",
    "monitor_id": "mon_abc123",
    "status": "operational",
    "position": 2,
    "created_at": "2026-03-07T16:10:00Z"
  }
}
```

## Delete a component

DELETE `/status-pages/:id/components/:cid`

Remove a component from a status page.

```bash
curl -X DELETE -H "Authorization: Bearer hu_..." \
  "https://happyuptime.com/api/v1/status-pages/sp_001/components/comp_003"
```

```json
{
  "data": {
    "id": "comp_003",
    "deleted": true
  }
}
```