The API is REST over HTTPS, JSON in and out, authenticated with a bearer token you generate in the dashboard.
curl -X POST https://api.uptimeglass.safeeclipse.online/v1/checks \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"type":"http","url":"https://example.com/health",
"interval":20,"regions":["eu-west","us-east","ap-south"],
"assert":{"status":200,"body_contains":"ok"}}'| Method | Path | Purpose |
|---|---|---|
| GET | /v1/checks | List checks with current state |
| POST | /v1/checks | Create a check |
| PATCH | /v1/checks/{id} | Update interval, regions or assertions |
| GET | /v1/checks/{id}/results | Raw samples, paginated |
| GET | /v1/incidents | Incident history with timelines |
| POST | /v1/maintenance | Schedule a window that suppresses alerts |
{
"event": "incident.opened",
"check": {"id": "chk_8f21", "name": "api.example.com"},
"incident": {"id": "inc_2a90", "started_at": "2026-08-01T14:22:07Z"},
"confirmed_by": ["eu-west", "us-east"],
"disagreed": ["ap-south"],
"error": "dial tcp: i/o timeout"
}Every request carries an X-UG-Signature header: HMAC-SHA256 of the raw body with your endpoint secret. Verify it before trusting the payload.
On the Scale plan we commit to 99.9% availability of the alerting pipeline, measured monthly. Missing it credits 10% of the monthly fee per 0.1% below target, up to 50%. Claims go to sla@uptimeglass.safeeclipse.online within 30 days of the incident.
Standard terms of service, a GDPR-compliant privacy notice and a signable data processing agreement are available on request from legal@uptimeglass.safeeclipse.online. Probe data is stored exclusively in the EU (Falkenstein and Amsterdam) regardless of which regions you monitor from.