> ## 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.

# Add status update

Post a new status update on an existing incident.

# Add status update

POST `/incidents/:id/updates`

Add a status update to an incident. Customer-facing updates are shown on the status page and emailed to subscribers.

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

## Body parameters

Update message (shown to subscribers).

New status: `investigating`, `identified`, `monitoring`, `resolved`.

Internal note — if `true`, the update is not shown on the public status page.

## Request

```bash
curl -X POST -H "Authorization: Bearer hu_..." \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Fix deployed, monitoring recovery.",
    "status": "monitoring"
  }' \
  "https://happyuptime.com/api/v1/incidents/inc_847/updates"
```

## Response

```json
{
  "data": {
    "id": "upd_003",
    "incident_id": "inc_847",
    "status": "monitoring",
    "message": "Fix deployed, monitoring recovery.",
    "is_internal": false,
    "created_at": "2026-03-07T15:45:00Z"
  }
}
```