REST API

Statance REST API reference: authentication, servers, metrics, monitors, alerts, recipients, incidents and status pages.

Base URL https://api.statance.com (also available at https://statance.com/v1/…). Requests and responses are JSON.

Authentication

Send your API key from Settings as a bearer token. It is the same key the agent uses — rotate it in Settings if it leaks (then re-run the installer on your servers).

curl https://api.statance.com/v1/me -H "Authorization: Bearer YOUR_API_KEY"

Account

GET /v1/me

Your account, plan and usage.

Servers

GET /v1/servers

GET /v1/servers/:id

PATCH /v1/servers/:id

Body: {"name": "web-1"}

DELETE /v1/servers/:id

GET /v1/servers/:id/metrics?range=24h

range: 1h, 24h, 7d, 30d, 90d, 365d (capped by plan retention). Longer ranges are downsampled.

{
  "points": [
    { "ts": 1761900000, "cpu": 23.4, "load1": 0.82, "temp": 48,
      "mem_pct": 51.2, "mem_used": 4398046511, "mem_total": 8589934592,
      "disk_pct": 40.1, "net_rx": 11.7, "net_tx": 3.3 }
  ]
}

GET /v1/servers/:id/processes

Latest top-process snapshot.

Monitors

GET /v1/monitors

POST /v1/monitors

GET /v1/monitors/:id

PATCH /v1/monitors/:id

DELETE /v1/monitors/:id

POST /v1/monitors/:id/pause

POST /v1/monitors/:id/resume

GET /v1/monitors/:id/checks?range=24h

GET /v1/monitors/:id/uptime?days=90

Body fields are described in Monitors.

Alert rules

GET /v1/alerts

POST /v1/alerts

PATCH /v1/alerts/:id

DELETE /v1/alerts/:id

See Alert rules.

Recipients (channels)

GET /v1/channels

POST /v1/channels

PATCH /v1/channels/:id

DELETE /v1/channels/:id

POST /v1/channels/:id/test

See Notifications.

Incidents

GET /v1/incidents?status=open

status: open or resolved. Each incident includes ai_summary when the assistant has investigated it.

Status pages

GET /v1/status-pages

POST /v1/status-pages

PATCH /v1/status-pages/:id

DELETE /v1/status-pages/:id

Agent ingest

POST /v1/ingest

See Agent.

Errors

Errors return a non-2xx status with {"error": "message"}. 401 = bad or missing key, 400 = validation failed or plan limit reached, 404 = not found or not yours, 429 = rate limited.

Next: MCP server →