Management API
The management API runs on https://cloud.seiri.app. It is used by the dashboard, seirictl, and automation.
Heartbeats do not use this host — see Ping API.
Authentication
Today org-scoped calls use a session / SSO access token plus org header:
Authorization: Bearer <access_token>
X-Org-ID: <numeric_org_id>
Long-lived org API keys (sk_…) are planned; they are not creatable in the Settings UI yet. Prefer the dashboard or seirictl with a user access token for now.
Common routes
| Method | Path | Purpose |
|---|---|---|
| GET/POST | /api/webhooks | List / create monitors |
| GET/PUT/DELETE | /api/webhooks/{id} | Read / update / delete |
| GET | /api/webhooks/{id}/logs | Event logs |
| POST | /api/webhooks/{id}/test | Send a test event |
| GET/POST | /api/email-heartbeat | Email heartbeat configs |
| GET/POST | /api/status-pages/ | Status pages |
| GET | /api/v1/sla/uptime | SLA overview |
| GET/POST | /api/v1/k8s/tenant/clusters | Kubernetes clusters |
OpenAPI: /docs/openapi/seiri-management-api.yaml.
Example (curl)
export SEIRI_TOKEN="eyJ..."
export SEIRI_ORG_ID="42"
curl -sS https://cloud.seiri.app/api/webhooks \
-H "Authorization: Bearer $SEIRI_TOKEN" \
-H "X-Org-ID: $SEIRI_ORG_ID"