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

name string required

Component name.

description string

Component description.

monitor_id string

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
  }
}

Was this page helpful?

Previous Delete status page

Next Alert channels