Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Mark an open incident as acknowledged
status: "acknowledged". The caller is recorded as the assignee and the status note is Incident acknowledged. Only open incidents can be acknowledged.
POST /api/incidents/{id}/acknowledge
X-API-Key: YOUR_API_KEY (read_write scope) or Authorization: Bearer YOUR_JWT. Requires the can_manage_incidents permission.
| Parameter | Type | Description |
|---|---|---|
id | UUID | Incident ID. No request body is needed. |
curl -X POST https://api.uptimeio.com/api/incidents/3f6c1a52-9d1e-4b0a-8f7d-2a1b3c4d5e6f/acknowledge \
-H "X-API-Key: YOUR_API_KEY"
200 OK, same shape as Update Status.
{
"success": true,
"data": {
"success": true,
"incident": {
"id": "3f6c1a52-9d1e-4b0a-8f7d-2a1b3c4d5e6f",
"check_id": "8d9e0f1a-2b3c-4d5e-8f6a-7b8c9d0e1f2a",
"monitor_name": "Checkout API",
"check_type": "HTTP",
"organization_id": "0b0f7a0e-2c3d-4f55-9a11-6f1c2f1d9a10",
"project_id": "7c1d2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
"status": "acknowledged",
"severity": "critical",
"type": "timeout",
"source": "system",
"started_at": "2026-09-30T09:12:04.000Z",
"acknowledged_at": "2026-09-30T09:15:00.000Z",
"acknowledged_by_name": "On Call",
"error_message": "Request timed out after 30000ms",
"affected_regions": ["europe", "asia"],
"failure_count": 3,
"notification_sent": true,
"notification_channels": ["email", "slack"],
"created_at": "2026-09-30T09:12:05.000Z",
"updated_at": "2026-09-30T09:15:00.000Z"
}
}
}
| Status | Code | When |
|---|---|---|
400 | VALIDATION_ERROR | Invalid id, or the incident is not open (for example Incident is already in status: acknowledged). |
401 | MISSING_AUTH, INVALID_API_KEY, INVALID_TOKEN | Missing or invalid credentials. |
403 | READ_ONLY_API_KEY, INSUFFICIENT_PERMISSIONS | Key is read-only, or the user cannot manage incidents. |
404 | RESOURCE_NOT_FOUND | No such incident in your project. |
Was this page helpful?