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"
}'
const response = await fetch('https://kodostatus.com/api/v1/uptime-monitors', {
method: 'POST',
headers: {
'X-API-Key': process.env.KODO_API_KEY,
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'API Health Check',
url: 'https://api.example.com/health',
interval_seconds: 300
})
});
{
"id": "uuid",
"name": "API Health Check",
"url": "https://api.example.com/health",
"interval_seconds": 300,
"enabled": true
}
Uptime Monitors
Create Uptime Monitor
Create a new HTTP uptime monitor
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"
}'
const response = await fetch('https://kodostatus.com/api/v1/uptime-monitors', {
method: 'POST',
headers: {
'X-API-Key': process.env.KODO_API_KEY,
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'API Health Check',
url: 'https://api.example.com/health',
interval_seconds: 300
})
});
{
"id": "uuid",
"name": "API Health Check",
"url": "https://api.example.com/health",
"interval_seconds": 300,
"enabled": true
}
Body Parameters
string
required
Monitor name
string
required
URL to monitor (must be HTTPS)
integer
default:"300"
Check interval:
60, 300, 600, 1800 secondsstring
Link to a service for automatic status updates
integer
default:"200"
Expected HTTP status code
integer
default:"30000"
Request timeout in milliseconds
integer
default:"3"
Number of consecutive failures required before creating an incident. Higher values reduce false positives.
integer
default:"900"
Minimum seconds between auto-created incidents for this monitor. Prevents duplicate incidents during intermittent failures.
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"
}'
const response = await fetch('https://kodostatus.com/api/v1/uptime-monitors', {
method: 'POST',
headers: {
'X-API-Key': process.env.KODO_API_KEY,
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'API Health Check',
url: 'https://api.example.com/health',
interval_seconds: 300
})
});
{
"id": "uuid",
"name": "API Health Check",
"url": "https://api.example.com/health",
"interval_seconds": 300,
"enabled": true
}