Skip to main content
PUT
Pin a Model Route into a client slot

Authorizations

Authorization
string
header
required

A Barndoor API key, sent as Authorization: Bearer <key>. Keys are prefixed bdai_ and are opaque — do not attempt to decode one. Interchangeable with an OAuth 2.0 access token.

Scopes

openid

Issue an OIDC ID token identifying the caller.

profile

Read the caller's basic profile claims.

email

Read the caller's email address.

Path Parameters

client
string
required

claude (Claude Code), codex (Codex) or kilo (Kilo Code)

slot_key
string
required

The slot's launch config key (model or an ANTHROPIC_DEFAULT_*_MODEL key)

Body

application/json
model_alias
string
required

The Model Route alias to pin into the slot. For a Default slot of Claude Code or Kilo Code a routing-policy alias is accepted too. A trailing [1m] is dropped.

change_note
string | null

Optional note recorded on the audit event.

Response

The saved pin and any non-blocking findings

pin
object
required

One pinned slot, as stored.

warnings
object[]
required

Non-blocking findings: family_mismatch (a Claude family slot pinned to a route whose primary model is of another family) and seat_only_route for Claude Code.