Models

2 operations. {prefix} is the route prefix passed to MapAgentPrism; the template uses /agentprism.

GET {prefix}/api/models/health

Operation ID: AgentPrismModelsHealth

Returns the cached health status of all registered providers.

If a provider does not implement IModelProviderHealthCheck, its status is Unknown; this is not an error. A provider whose circuit is open shows as Unhealthy. The error detail does NOT include an API key or endpoint address.

Authorization: bearer authentication; Reader role policy when that policy is registered; PlatformRead API-key scope.

Parameter	In	Required	Type	Description and rules
refresh	query	no	boolean	—

Response	Body	Headers
200 OK	application/json → array of ModelProviderHealth	—

GET {prefix}/api/models/health/{provider}

Operation ID: AgentPrismModelHealth

Returns the cached health status of a single provider.

The status is served from the cache; add ‘?refresh=true’ to force a fresh check. A check reads the provider’s model list and never runs a completion, so it costs nothing. An unregistered provider name returns 404 — which is different from a registered provider that reports Unknown because it implements no health check. Error details never carry an API key or an endpoint address.

Authorization: bearer authentication; Reader role policy when that policy is registered; PlatformRead API-key scope.

Parameter	In	Required	Type	Description and rules
provider	path	yes	string	—
refresh	query	no	boolean	—

Response	Body	Headers
200 OK	application/json → ModelProviderHealth	—