Skip to main content
POST
/
uptime-monitors
curl -X POST "https://kodostatus.com/api/v1/uptime-monitors" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "API Health Check",
    "url": "https://api.example.com/health",
    "interval_seconds": 300,
    "service_id": "uuid"
  }'

{
  "id": "uuid",
  "name": "API Health Check",
  "url": "https://api.example.com/health",
  "interval_seconds": 300,
  "enabled": true
}

​
Body Parameters

​
name
string
required
Monitor name
​
url
string
required
URL to monitor (must be HTTPS)
​
interval_seconds
integer
default:"300"
Check interval: 60, 300, 600, 1800 seconds
​
service_id
string
Link to a service for automatic status updates
​
expected_status_code
integer
default:"200"
Expected HTTP status code
​
timeout_ms
integer
default:"30000"
Request timeout in milliseconds
​
consecutive_failure_threshold
integer
default:"3"
Number of consecutive failures required before creating an incident. Higher values reduce false positives.
​
incident_cooldown_seconds
integer
default:"900"
Minimum seconds between auto-created incidents for this monitor. Prevents duplicate incidents during intermittent failures.
​
auto_incident_severity
string
Override severity for auto-created incidents: minor, major, critical. Omit to use the default (Major for uptime, Minor for heartbeat).

​
Response

Returns the created monitor object. 
curl -X POST "https://kodostatus.com/api/v1/uptime-monitors" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "API Health Check",
    "url": "https://api.example.com/health",
    "interval_seconds": 300,
    "service_id": "uuid"
  }'

{
  "id": "uuid",
  "name": "API Health Check",
  "url": "https://api.example.com/health",
  "interval_seconds": 300,
  "enabled": true
}