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": "uuid",
  "title": "Database connectivity issues",
  "status": "investigating",
  "severity": "major",
  "started_at": "2024-01-15T10:30:00Z"
}

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": "uuid",
  "title": "Database connectivity issues",
  "status": "investigating",
  "severity": "major",
  "started_at": "2024-01-15T10:30:00Z"
}