Get route health
LLM Gateway: Route Health
Get Route Health
Returns a per-route operational view of upstream health: which routes are currently healthy, half-open (probing), or ejected (cooling down), along with consecutive-failure counts and recent state transitions. Useful for dashboards and incident triage.
GET
Get route health
Returns a per-route operational view of upstream health. Useful for dashboards,
alerting integrations, and incident triage.
Route states
| State | Meaning |
|---|---|
healthy | The route is serving traffic normally. |
half_open | The route was recently ejected; the gateway is letting a small probe of traffic through to test recovery. |
ejected | The route has been temporarily removed from the failover loop. New traffic will skip it until eject_remaining_secs elapses. |
cooldown_reason explains why a route is in cooldown:
rolling_failures— too many upstream errors in the rolling window.rate_limited— the upstream returned 429s faster than the route’s retry policy could absorb them.
Recovery
Routes recover automatically as cooldown windows expire and probe traffic succeeds. To force a route back to healthy immediately — for example after an upstream incident is resolved — callPOST /admin/llm-gw/route-health/{provider_id}/reset.Authorizations
JWT obtained through Barndoor's authentication flow. Pass the token
verbatim in Authorization: Bearer <token>. Use the Barndoor SDK's
loginInteractive() helper to obtain a token in scripts and notebooks.
Response
200 - application/json
Route health snapshot
