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

# Update incident

Change an incident's title, severity, or status.

# Update incident

PUT `/incidents/:id`

Update incident title, severity, or status.

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

## Body parameters

Incident title.

Severity: `minor`, `major`, `critical`.

Status: `investigating`, `identified`, `monitoring`, `resolved`.

## Request

```bash
curl -X PUT -H "Authorization: Bearer hu_..." \
  -H "Content-Type: application/json" \
  -d '{"severity": "critical"}' \
  "https://happyuptime.com/api/v1/incidents/inc_847"
```

## Response

```json
{
  "data": {
    "id": "inc_847",
    "title": "API latency spike",
    "status": "investigating",
    "severity": "critical",
    "started_at": "2026-03-07T14:22:00Z",
    "updated_at": "2026-03-07T15:00:00Z"
  }
}
```

To append a status update message (instead of overwriting the incident fields), use [`POST /incidents/:id/updates`](/api/incidents/add-update).