Uptime & Incident Aggregator API

MVP docs · Use Authorization: Bearer <token> for all /v1 endpoints except /v1/health.

Getting an API key

Create an account, verify your email, then go to Dashboard → API Keys to generate a key. Keys are shown only once.

Authorization: Bearer YOUR_KEY

Health

No auth

GET /v1/health

Summary

GET /v1/summary

Monitors

GET /v1/monitors

POST /v1/monitors
{
  "name": "My site",
  "url": "https://example.com/",
  "method": "HEAD",
  "expected_status": 200,
  "timeout_ms": 5000,
  "interval_sec": 60
}

GET /v1/monitors/{id}

PATCH /v1/monitors/{id}
{"is_active":0}

GET /v1/monitors/{id}/history?limit=200

Incidents

GET /v1/incidents?status=open&limit=100

GET /v1/incidents/{id}

Example curl

curl -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Example","url":"https://example.com","method":"HEAD"}' \
  https://YOURDOMAIN/v1/monitors

AS-IS

This API is provided “AS IS” without warranty. Always verify incidents with your own monitoring.