Skip to main content
Services represent the different components of your system that you want to display on your status page.

​
Service Statuses

StatusColorUse When
OperationalGreenEverything is working normally
DegradedYellowPerformance issues but functional
Partial OutageOrangeSome functionality unavailable
Major OutageRedService is down
MaintenanceBlueScheduled maintenance in progress

​
Adding Services

  1. Go to Dashboard > Services
  2. Click Add Service
  3. Enter name and description
  4. Optionally assign to a group
  5. Click Create

​
Service Groups

Organize related services into groups: 
Infrastructure
├── API Gateway
├── Database
└── Cache

User-Facing
├── Web App
├── Mobile API
└── CDN

​
Updating Service Status

Update status manually or let monitors do it automatically: 
# Manual update
kodo service update svc_abc123 --status degraded

# Or via API
curl -X PATCH "https://kodostatus.com/api/v1/services/svc_abc123" \
  -H "X-API-Key: your_api_key" \
  -d '{"status": "degraded"}'

​
Linking to Monitors

Connect services to uptime monitors for automatic status updates:
  1. Create a service
  2. Create an uptime monitor
  3. Set the monitor’s service_id to your service
  4. When the monitor detects issues, the service status updates automatically

​
Display Order

Control the order services appear on your status page: 
kodo service update svc_abc123 --display-order 1
kodo service update svc_def456 --display-order 2
Lower numbers appear first.