Replace 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. :::

Replace the entire rule definition. Any field omitted from the body is reset to its default. Use Update route for partial changes.

PUT /v1/routes/{id} Coming soon

https://api.routeur.ai

Path parameters

id string required

Route id, e.g. route_01J....

Returns

The replaced Route object with a fresh updated_at.

← Retrieve route Update route →

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

await fetch(`https://api.routeur.ai/v1/routes/${id}`, { method: "PUT", headers: { Authorization: `Bearer ${process.env.ROUTEUR_KEY}`, "Content-Type": "application/json" }, body: JSON.stringify(fullRoute) });