The Route object
:::callout amber
Not available yet. The management API is documented ahead of its implementation — the request and response shapes below are a stable contract we're committing to, but calling these endpoints today returns 404. Manage routing rules in the dashboard in the meantime. The live gateway endpoints today are POST /v1/chat/completions, POST /v1/embeddings and GET /v1/models.
:::
A routing rule that maps a caller request to a concrete (provider, model) pair. Rules are evaluated highest priority first; the first matching rule wins.
Attributes
id
string
Unique identifier, prefixed
route_.name
string
Human-readable rule identifier surfaced in trace metadata as
rule:<name>.priority
integer
Higher numbers evaluate first.
enabled
boolean
Disabled rules are skipped at runtime.
action_kind
pin | auto
pin sends to a fixed provider/model pair. auto defers to routeur.ai's picker.match
object
Match condition. Currently supports
requested_model (exact string match).action
object
Resolution. For
pin: provider + model.created_at
timestamp
ISO-8601 UTC timestamp.
updated_at
timestamp
ISO-8601 UTC timestamp.