# Models

> Tracon documentation. Tracon is a .NET package family that adds a control
> plane on Microsoft Agent Framework, published as NuGet packages that run
> inside your own ASP.NET Core application.
>
> Page: https://tracon.dev/http-api/models/
> Summary: The models endpoints of the Tracon HTTP API — 2 operations.

2 operations. `{prefix}` is the route prefix passed to
`MapTracon`; the template uses `/tracon`.

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

**Operation ID:** `TraconModelsHealth`

**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`](/http-api/schemas/modelproviderhealth/) | — |

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

**Operation ID:** `TraconModelHealth`

**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`](/http-api/schemas/modelproviderhealth/) | — |