Skip to main content
GET
List all model routes

Authorizations

Authorization
string
header
required

An access token from Barndoor's identity provider, sent as Authorization: Bearer <token>. Use a service-account token from the OAuth 2.0 client-credentials grant for scripts and CI, or a signed-in user's token. The caller needs the admin role in the organization. Gateway API keys (bd-...) are not accepted here.

Response

OK

cooldown_429_default_secs
integer<int32>
required

Cooldown after an upstream 429 with no usable Retry-After, in seconds.

cooldown_base_secs
integer<int32>
required

First cooldown window, in seconds. Doubles after each failed recovery probe, up to cooldown_max_secs.

cooldown_failure_threshold
integer<int32>
required

Gateway failures within cooldown_window_secs that put the route in cooldown. 0 disables cooldowns for the route.

cooldown_max_secs
integer<int32>
required

Longest cooldown window, in seconds.

cooldown_overloaded_secs
integer<int32>
required

Cooldown after an upstream 529 (overloaded) with no usable Retry-After, in seconds. 0 treats a 529 as an ordinary failure.

cooldown_window_secs
integer<int32>
required

Length of the rolling failure window, in seconds.

bare_alias
boolean
required
created_at
string<date-time>
required

When the route was created.

enabled
boolean
required
id
string<uuid>
required
model_alias
string
required
priority
integer<int32>
required
provider_auth_type
string
required
provider_id
string<uuid>
required
provider_name
string
required
retry_on_429_count
integer<int32>
required
retry_on_429_max_wait_secs
integer<int32>
required
source
enum<string>
required

Whether the model was chosen from the catalog or typed in when the route was created.

Available options:
catalog,
custom
upstream_model
string
required
effective_pricing
object
required

The rate a request on a route would be billed at. When source is none, no pricing rule or Barndoor default covers the model: requests succeed but record no cost. When source is not_metered, the provider is set to record no cost.

created_by_email
string | null
created_by_name
string | null
created_by_user_id
string<uuid> | null
last_change_note
string | null

Note explaining the last change.

last_modified_at
string<date-time> | null

When the last attributed change was made.

last_modified_by_email
string | null
last_modified_by_name
string | null
last_modified_by_user_id
string<uuid> | null
auto_disabled_reason
null | enum<string>

Set when the gateway disabled this route because the model left the provider's catalog.

Available options:
catalog_retired
request_timeout_secs
integer<int32> | null
stream_idle_timeout_secs
integer<int32> | null
budget_status
null | object

Present on a route when an exhausted budget with action_on_exhaust: block targets it.

route_health_status
null | object

Present while a route is in a health cooldown.

stale_status
null | object

Present when the provider's catalog no longer lists this model. Advisory only.