Set a customer's default routing policy

curl -X PUT https://api-gateway.merge.dev/v1/customers/customer_id/default-routing-policy \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "routing_policy_id": "2a1b3c4d-5e6f-4708-9a0b-1c2d3e4f5a6b"
}'

{
  "id": "2a1b3c4d-5e6f-4708-9a0b-1c2d3e4f5a6b",
  "name": "workflow-a",
  "description": "Primary workflow routing",
  "strategy": "PRIORITY",
  "is_default": true,
  "allowed_providers": [
    "openai",
    "anthropic"
  ],
  "allowed_models": [
    "openai/gpt-5.5",
    "anthropic/claude-opus-4-8"
  ],
  "priority_order": [
    {
      "model": "openai/gpt-5.5",
      "priority": 1
    },
    {
      "model": "anthropic/claude-opus-4-8",
      "priority": 2
    }
  ],
  "axis": "COST",
  "created_at": "2026-07-01T12:00:00Z",
  "modified_at": "2026-07-01T12:00:00Z"
}

Marks one of the customer’s existing policies as its default: the policy that routes a request carrying customer but no model and no routing_policy_id. The previous default is cleared. The policy must belong to this customer (404 otherwise) and be active (422).

Authentication

AuthorizationBearer

Your production key sent as a bearer token.

Path parameters

customer_idstringRequired

Request

This endpoint expects an object.

routing_policy_idstringRequiredformat: "uuid"

Response

The policy, now the default.

idstringOptional

namestringOptional

descriptionstring or nullOptional

Optional free-text description

strategyenumOptional

Allowed values:

is_defaultbooleanOptional

Used when a request names no explicit policy.

allowed_providerslist of strings or nullOptional

allowed_modelslist of strings or nullOptional

priority_orderlist of objects or nullOptional

axisenum or nullOptional

Optimization axis the router optimizes for. Set for INTELLIGENT policies; null for PRIORITY.

Allowed values:

created_atdatetimeOptional

modified_atdatetimeOptional