Overview
Delete an incident from your status page. This action removes the incident and its entire history from the status page. Deleted incidents cannot be recovered.
Deleting an incident is permanent and cannot be undone. The incident and all associated updates will be removed from the status page history.
Authentication
All requests must include authentication via API Key:
- API Key:
X-API-Key: YOUR_API_KEY
Request
curl -X DELETE https://api.uptimeio.com/api/projects/660e8400-e29b-41d4-a716-446655440001/status-pages/550e8400-e29b-41d4-a716-446655440000/incidents/990e8400-e29b-41d4-a716-446655440050 \
-H "X-API-Key: YOUR_API_KEY"
Path Parameters
| Parameter | Type | Description |
|---|
projectId | UUID | The ID of the project |
statusPageId | UUID | The ID of the status page |
id | UUID | The ID of the incident to delete |
Response
Returns confirmation of deletion.
{
"success": true,
"data": {
"deleted": true,
"incident_id": "990e8400-e29b-41d4-a716-446655440050"
}
}
Response Fields
| Field | Type | Description |
|---|
success | boolean | Indicates successful operation |
data | object | Response data container |
data.deleted | boolean | Confirmation that incident was deleted |
data.incident_id | string | ID of the deleted incident |
Status Codes
| Status | Description |
|---|
200 | Incident deleted successfully |
401 | Unauthorized (missing or invalid token) |
403 | Forbidden (no permission to delete incident) |
404 | Incident or status page not found |
Examples
Delete an Incident
curl -X DELETE https://api.uptimeio.com/api/projects/660e8400-e29b-41d4-a716-446655440001/status-pages/550e8400-e29b-41d4-a716-446655440000/incidents/990e8400-e29b-41d4-a716-446655440050 \
-H "X-API-Key: YOUR_API_KEY"
Error Codes
Incident Not Found
{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Incident not found"
}
}
Status Page Not Found
{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Status page not found"
}
}
Forbidden
{
"success": false,
"error": {
"code": "FORBIDDEN",
"message": "You do not have permission to delete this incident"
}
}
Unauthorized
{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required"
}
}
