Skip to main content

Status Pages API

Create and manage public status pages that display uptime for your services.

Base URL: https://app.kamustatus.com/api

Status pages are publicly accessible at:

https://app.kamustatus.com/status/<slug>

List Status Pages​

curl https://app.kamustatus.com/api/status-pages \
  -H "x-api-key: km_your_api_key"

Get Status Page​

curl https://app.kamustatus.com/api/status-pages/:statusPageId \
  -H "x-api-key: km_your_api_key"

Create Status Page​

curl -X POST https://app.kamustatus.com/api/status-pages \
  -H "x-api-key: km_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Status",
    "slug": "acme",
    "monitorIds": ["mon_abc123", "mon_def456"]
  }'

The page will be available at https://app.kamustatus.com/status/acme.

Update Status Page​

curl -X PATCH https://app.kamustatus.com/api/status-pages/:statusPageId \
  -H "x-api-key: km_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Service Status",
    "monitorIds": ["mon_abc123", "mon_def456", "mon_ghi789"]
  }'

Delete Status Page​

curl -X DELETE https://app.kamustatus.com/api/status-pages/:statusPageId \
  -H "x-api-key: km_your_api_key"

Custom Domains​

You can serve a status page on your own domain (e.g. status.example.com) by creating a CNAME record.

Setup​

  1. Add a CNAME DNS record pointing your domain to app.kamustatus.com:

    status.example.com  CNAME  app.kamustatus.com

  2. Update the status page with your custom domain:

    curl -X PATCH https://app.kamustatus.com/api/status-pages/:statusPageId \
      -H "x-api-key: km_your_api_key" \
      -H "Content-Type: application/json" \
      -d '{
        "customDomain": "status.example.com"
      }'

  3. Kamustatus will automatically provision an SSL certificate for the custom domain.