Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Post a progress update on an incident timeline
resolved also records the resolution time; Resolve Status Page Incident is a shortcut for that.
POST /api/projects/{projectId}/status-pages/{statusPageId}/incidents/{id}/updates
| Header | Required | Description |
|---|---|---|
X-API-Key | Yes | Your API key (Authorization: Bearer {jwt} also works). API keys need the read_write scope. |
Content-Type | Yes | application/json |
X-Project-ID header is needed.
| Parameter | Type | Description |
|---|---|---|
projectId | UUID | The project |
statusPageId | UUID | The status page |
id | UUID | The incident |
| Field | Type | Required | Description |
|---|---|---|---|
message | string | Yes | 1-5000 characters |
status | string | Yes | investigating, identified, monitoring or resolved |
{
"success": true,
"data": {
"update": {
"id": "f0e1d2c3-b4a5-4968-8796-a5b4c3d2e1f0",
"status_page_incident_id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
"message": "We have identified the cause and are deploying a fix.",
"status": "identified",
"posted_at": "2026-09-30T12:10:00.000Z"
}
}
}
| Field | Type | Description |
|---|---|---|
id | UUID | Update ID |
status_page_incident_id | UUID | The incident |
message | string | The update text |
status | string | The status set by this update |
posted_at | string | ISO 8601 timestamp |
| Status | Code | Cause |
|---|---|---|
| 400 | VALIDATION_ERROR | Invalid body |
| 401 | AUTHENTICATION_REQUIRED | Missing or invalid credentials, or the caller is not a project admin (message Access denied) |
| 403 | API_KEY_ORGANIZATION_MISMATCH | The API key belongs to a different organization than the project |
| 403 | READ_ONLY_API_KEY | The API key has the read scope |
| 404 | RESOURCE_NOT_FOUND | The status page or incident does not exist, or the incident belongs to a different status page |
curl -X POST https://api.uptimeio.com/api/projects/YOUR_PROJECT_ID/status-pages/YOUR_STATUS_PAGE_ID/incidents/YOUR_INCIDENT_ID/updates \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "status": "identified", "message": "We have identified the cause and are deploying a fix." }'
const base = 'https://api.uptimeio.com/api/projects/YOUR_PROJECT_ID/status-pages/YOUR_STATUS_PAGE_ID';
const response = await fetch(`${base}/incidents/YOUR_INCIDENT_ID/updates`, {
method: 'POST',
headers: {
'X-API-Key': process.env.UPTIMEIO_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
status: 'identified',
message: 'We have identified the cause and are deploying a fix.',
}),
});
const { data } = await response.json();
console.log(data.update.id);
Was this page helpful?