Replace a route

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} Preview

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)
});

requests.put(
    f"https://api.routeur.ai/v1/routes/{route_id}",
    headers={"Authorization": f"Bearer {os.environ['ROUTEUR_KEY']}"},
    json=full_route,
)

200 application/json

Response

{
  "id":          "route_01J...",
  "name":        "premium_demo",
  "priority":    200,
  "updated_at":  "2026-05-29T11:00:00Z"
}