Skip to main content

​
Overview

Update an existing incident on your status page. You can modify the title, message, severity, status, and affected monitors. Each update is tracked in the incident history.

​
Authentication

All requests must include authentication via API Key:
  • API Key: X-API-Key: YOUR_API_KEY

​
Request

curl -X PATCH 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 "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "title": "API Service Degradation - Root Cause Identified",
    "message": "We have identified the root cause and are implementing a fix",
    "status": "identified"
  }'

​
Path Parameters

ParameterTypeDescription
projectIdUUIDThe ID of the project
statusPageIdUUIDThe ID of the status page
idUUIDThe ID of the incident

​
Request Body

All fields are optional. Omit fields you don’t want to modify.
FieldTypeDescription
titlestringNew incident title (1-200 characters)
messagestringNew incident message (1-5000 characters)
severitystringNew severity: minor, major, critical
statusstringNew status: investigating, identified, monitoring, resolved
affected_monitor_idsUUID[]New list of affected monitor IDs (min 1 if provided)

​
Response

Returns the updated incident object. 
{
  "success": true,
  "data": {
    "incident": {
      "id": "990e8400-e29b-41d4-a716-446655440050",
      "status_page_id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "API Service Degradation - Root Cause Identified",
      "message": "We have identified the root cause and are implementing a fix",
      "severity": "major",
      "status": "identified",
      "affected_monitor_ids": [
        "770e8400-e29b-41d4-a716-446655440010",
        "770e8400-e29b-41d4-a716-446655440011"
      ],
      "created_at": "2024-12-26T11:00:00Z",
      "updated_at": "2024-12-26T12:15:00Z",
      "resolved_at": null,
      "updates": []
    }
  }
}

​
Response Fields

FieldTypeDescription
idUUIDUnique incident identifier
status_page_idUUIDStatus page ID
titlestringUpdated incident title
messagestringUpdated incident message
severitystringUpdated severity level
statusstringUpdated status
affected_monitor_idsUUID[]Updated list of affected monitors
created_attimestampCreation timestamp (unchanged)
updated_attimestampUpdated timestamp
resolved_attimestamp | nullResolution timestamp

​
Status Codes

StatusDescription
200Incident updated successfully
400Validation error (invalid data or monitors)
401Unauthorized (missing or invalid token)
403Forbidden (no permission to update incident)
404Incident or status page not found

​
Examples

​
Update Incident Status to “Identified”

curl -X PATCH 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" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "identified",
    "message": "We have identified the issue - a misconfigured load balancer. Fix in progress."
  }'

​
Escalate Incident Severity

curl -X PATCH 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" \
  -H "Content-Type: application/json" \
  -d '{
    "severity": "critical",
    "message": "Escalating to critical - affecting all regions"
  }'

​
Add Affected Monitors

curl -X PATCH 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" \
  -H "Content-Type: application/json" \
  -d '{
    "affected_monitor_ids": [
      "770e8400-e29b-41d4-a716-446655440010",
      "770e8400-e29b-41d4-a716-446655440011",
      "770e8400-e29b-41d4-a716-446655440012"
    ]
  }'

​
Error Codes

​
Validation Error - Invalid Status

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validation failed: status: Invalid enum value. Expected 'investigating' | 'identified' | 'monitoring' | 'resolved'"
  }
}

​
Invalid Monitor IDs

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid monitor IDs: 770e8400-e29b-41d4-a716-446655440099 - monitors must belong to this status page"
  }
}

​
Incident Not Found

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Incident not found"
  }
}

​
Forbidden

{
  "success": false,
  "error": {
    "code": "FORBIDDEN",
    "message": "You do not have permission to update this incident"
  }
}