Update routing rule

Updates an existing routing rule’s configuration.

PUT /api/routing/rules/{rule_id}

Error

A valid request URL is required to generate request examples

200

{
  "message": "<string>",
  "rule": {
    "scope": "global",
    "id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "enabled": true,
    "cel_expression": "<string>",
    "targets": [
      {
        "weight": 0.5,
        "provider": "<string>",
        "model": "<string>",
        "key_id": "<string>"
      }
    ],
    "fallbacks": [
      "<string>"
    ],
    "scope_id": "<string>",
    "priority": 123,
    "query": {},
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

ManagementBearerAuthBasicAuth

Authorization · string · header · required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <token>, where <token> is one of:

• a Bifrost management API key,
• a dashboard session token issued by POST /api/session/login,
• base64 of <admin-username>:<admin-password> (legacy equivalent of BasicAuth).

Virtual keys (sk-bf-*) and the x-api-key header are not accepted on management APIs - the sole exception is GET /api/governance/virtual-keys/quota, which is virtual-key-only.

Path Parameters

rule_id · string · required

Routing rule ID

Body

application/json

Request to update a routing rule (all fields optional; providing targets replaces all existing targets)

name · string

description · string

enabled · boolean

cel_expression · string

targets · object[]

Replaces all existing targets when provided; weights must sum to 1

Minimum array length: 1

Show child attributes

fallbacks · string[]

priority · integer

query · object | null

Response

200

application/json

Routing rule updated successfully

Response containing created/updated routing rule

message · string

rule · object

CEL-based routing rule for intelligent request routing

Option 1

Option 2

Show child attributes