Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Read an incident’s change history
GET /api/incidents/{id}/updates
X-API-Key: YOUR_API_KEY or Authorization: Bearer YOUR_JWT. A read-only key is sufficient.
| Parameter | Type | Description |
|---|---|---|
id | UUID | Incident ID. |
curl https://api.uptimeio.com/api/incidents/3f6c1a52-9d1e-4b0a-8f7d-2a1b3c4d5e6f/updates \
-H "X-API-Key: YOUR_API_KEY"
200 OK. data is an array, newest first.
{
"success": true,
"data": [
{
"id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
"incident_id": "3f6c1a52-9d1e-4b0a-8f7d-2a1b3c4d5e6f",
"action": "acknowledged",
"message": "Incident acknowledged",
"old_value": "open",
"new_value": "acknowledged",
"user_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"user_email": "[email protected]",
"user_name": "On Call",
"created_at": "2026-09-30T09:15:00.000Z"
}
]
}
| Field | Type | Description |
|---|---|---|
action | string | created, status_changed, severity_changed, acknowledged, resolved, closed, reopened, updated, assigned, or comment_added (a note added with Add Incident Update). |
message | string | null | Note attached to the entry. |
old_value / new_value | string | null | Previous and new value where relevant. |
user_id, user_email, user_name | string | null | Who made the change; null for system actions. |
created_at | string | ISO 8601 time. |
| Status | Code | When |
|---|---|---|
400 | VALIDATION_ERROR | id is not a UUID. |
401 | MISSING_AUTH, INVALID_API_KEY, INVALID_TOKEN | Missing or invalid credentials. |
404 | RESOURCE_NOT_FOUND | No such incident in your project. |
Was this page helpful?