Create a route
:::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.
:::
Add a new routing rule. The rule is active for new requests within a few seconds — the gateway re-reads rules at a short polling interval.
POST
/v1/routes
Coming soon
https://api.routeur.ai
Request body
name
string
required
Unique within the organisation. Surfaced in trace metadata.
priority
integer
optional · default 0
Higher numbers evaluate first.
enabled
boolean
optional · default true
Create disabled if you want to stage a rule without it taking effect.
action_kind
pin | auto
required
Resolution strategy.
match
object
required
Match condition. Currently supports
requested_model.action
object
required
For
pin, supply provider and model.Returns
The newly created Route object.