Create Uptime Monitor

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
}

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 seconds

string

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
}

List Uptime Monitors Get Uptime Monitor

Overview

Status Pages

Status Page Design

Incidents

Services

Uptime Monitors

SSL Monitors

Domain Monitors

Heartbeat

Metrics

Notification Channels

Webhooks

Error Tracking

Releases

Source Maps

Maintenance

Configuration

Workflows

API Keys

Audit Log

Beacon

Create Uptime Monitor

Body Parameters

Response

​Body Parameters

​Response

Body Parameters

Response