The Route object

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.

← Create chat completion List routes →