Create a route

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 Preview

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.

← List routes Retrieve route →

curl https://api.routeur.ai/v1/routes \ -H "Authorization: Bearer $ROUTEUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "premium_demo", "priority": 100, "action_kind": "pin", "match": { "requested_model": "demo-premium" }, "action": { "provider": "openai", "model": "gpt-4o" } }'

const res = await fetch("https://api.routeur.ai/v1/routes", { method: "POST", headers: { Authorization: `Bearer ${process.env.ROUTEUR_KEY}`, "Content-Type": "application/json" }, body: JSON.stringify({ name: "premium_demo", priority: 100, action_kind: "pin", match: { requested_model: "demo-premium" }, action: { provider: "openai", model: "gpt-4o" } }) });

r = requests.post( "https://api.routeur.ai/v1/routes", headers={"Authorization": f"Bearer {os.environ['ROUTEUR_KEY']}"}, json={ "name": "premium_demo", "priority": 100, "action_kind": "pin", "match": {"requested_model": "demo-premium"}, "action": {"provider": "openai", "model": "gpt-4o"}, }, )

{ "id": "route_01J...", "name": "premium_demo", "priority": 100, "enabled": true, "action_kind": "pin", "match": { "requested_model": "demo-premium" }, "action": { "provider": "openai", "model": "gpt-4o" }, "created_at": "2026-05-29T10:00:00Z" }