> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kodostatus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Services

> Manage the services and components displayed on your status page

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

## Service Statuses

| Status             | Color  | Use When                          |
| ------------------ | ------ | --------------------------------- |
| **Operational**    | Green  | Everything is working normally    |
| **Degraded**       | Yellow | Performance issues but functional |
| **Partial Outage** | Orange | Some functionality unavailable    |
| **Major Outage**   | Red    | Service is down                   |
| **Maintenance**    | Blue   | Scheduled maintenance in progress |

## Adding Services

<Tabs>
  <Tab title="Dashboard">
    1. Go to **Dashboard > Services**
    2. Click **Add Service**
    3. Enter name and description
    4. Optionally assign to a group
    5. Click **Create**
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    kodo services create \
      --name "API Gateway" \
      --description "Main API service" \
      --status operational
    ```
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    curl -X POST "https://kodostatus.com/api/v1/services" \
      -H "X-API-Key: your_api_key" \
      -H "Content-Type: application/json" \
      -d '{
        "name": "API Gateway",
        "description": "Main API service",
        "status": "operational"
      }'
    ```
  </Tab>
</Tabs>

## 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:

```bash theme={null}
# Manual update
kodo services status svc_abc123 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](/monitoring/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:

```bash theme={null}
kodo services update svc_abc123 --display-order 1
kodo services update svc_def456 --display-order 2
```

Lower numbers appear first.