v54

OpenAPI 3.1.0raw.githubusercontent.com2026-08-038690315.6 KB
providers

Provider Health

Report every configured provider's reachability, with a last-checked time.

Reuses the per-provider model-discovery test path, so a provider is healthy when its credentials can list models. Results are served from the discovery cache (cheap enough to poll), so checked_at reflects when each provider was actually dialed. Pass refresh=true to force a live re-dial of every provider. Master-key gated because it describes the gateway's own providers.

A provider whose backend serves no model-listing endpoint cannot be verified this way, but it is not unreachable either: it is reported with discovery_unsupported and counted under degraded rather than as a reachability failure.

get/v1/providers/health

Query parameters

refreshboolean

Response

Successful Response

checked_atstring nullable

ISO 8601 time of the most recent per-provider check (null if none yet).

degradedinteger

How many providers are not counted as reachable only because model discovery is unavailable for them. These may still serve requests.

healthyinteger required

How many providers are currently reachable.

totalinteger required

How many providers are configured.