Skip to main content
POST
/
incidents
curl -X POST "https://kodostatus.com/api/v1/incidents" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Database connectivity issues",
    "status": "investigating",
    "severity": "major",
    "message": "We are investigating reports of database issues",
    "services": ["API", "Database"]
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "title": "Database connectivity issues",
  "status": "investigating",
  "severity": "major",
  "started_at": "2026-01-15T10:30:00.000Z",
  "created_at": "2026-01-15T10:30:00.000Z",
  "updated_at": "2026-01-15T10:30:00.000Z"
}

​
Body Parameters

​
title
string
required
Incident title
​
status
string
default:"investigating"
Initial status: investigating, identified, monitoring, resolved
​
severity
string
default:"minor"
Severity level: minor, major, critical
​
message
string
Initial update message
​
services
array
Array of service names or IDs to link to this incident

​
Response

Returns the created incident object. 
curl -X POST "https://kodostatus.com/api/v1/incidents" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Database connectivity issues",
    "status": "investigating",
    "severity": "major",
    "message": "We are investigating reports of database issues",
    "services": ["API", "Database"]
  }'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "title": "Database connectivity issues",
  "status": "investigating",
  "severity": "major",
  "started_at": "2026-01-15T10:30:00.000Z",
  "created_at": "2026-01-15T10:30:00.000Z",
  "updated_at": "2026-01-15T10:30:00.000Z"
}