Skip to main content
GET
List a provider's 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.

Path Parameters

provider_id
string<uuid>
required

Provider ID (UUID)

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

Whether the route answers requests that name the alias alone. When false, the model is reachable only as <provider>/<upstream_model>. Custom aliases are always true.

enabled
boolean
required
id
string<uuid>
required
model_alias
string
required
priority
integer<int32>
required

Failover order among routes serving the same alias; lower is tried first.

provider_id
string<uuid>
required
retry_on_429_count
integer<int32>
required

Same-route retries on upstream 429. 0 means immediate failover.

retry_on_429_max_wait_secs
integer<int32>
required

Longest upstream Retry-After to honor, in seconds. 0 uses a short built-in wait and ignores the header.

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 this route would be billed at, and which pricing tier produced it.

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. Any admin change to enabled clears it.

Available options:
catalog_retired
request_timeout_secs
integer<int32> | null

Total-request timeout for non-streaming requests, in seconds (1–600).

stream_idle_timeout_secs
integer<int32> | null

Idle timeout between chunks of a streaming response, in seconds (1–300).

budget_status
null | object

Present when an exhausted blocking budget targets this route. The gateway skips the route while this is set.

route_health_status
null | object

Present while the route is in a health cooldown.

stale_status
null | object

Present when the provider's catalog no longer lists this model. Advisory only: nothing is disabled because of it.