GET /v1/health
Unauthenticated liveness. The only endpoint that requires no API key — usable by load balancers, uptime probes, and an integration deciding whether the runtime is back after a degraded-mode episode.
GET {base_url}/v1/health
Response
| Status | Body | Meaning |
|---|---|---|
200 | {"status": "ok", "version": "..."} | The runtime can serve decisions |
503 | {"status": "error", ...} | It cannot — treat as unreachable |
Example
curl -s $OGR_RUNTIME/v1/health
{ "status": "ok", "version": "ogr-airs/0.9.4" }
version is the runtime's own build id as "name/version" — the same grammar a
GuardEvent's integration uses, and the same string the runtime stamps on the
events it records, so "what am I running" has ONE answer. An unstamped build says
so out loud (ogr-airs/unstamped) rather than reporting a plausible number.
"Healthy" means can serve decisions — not merely "process is up". A runtime that is up but cannot reach its detectors or storage should answer 503, so integrations apply their configured fail mode instead of timing out per call.