Create routing policy

curl -X POST https://api-gateway.merge.dev/v1/customers/customer_id/routing-policies \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Acme",
  "strategy": "PRIORITY"
}'

{
  "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
    }
  ],
  "created_at": "2026-07-01T12:00:00Z",
  "modified_at": "2026-07-01T12:00:00Z"
}

Authentication

AuthorizationBearer

Your production key sent as a bearer token.

Path parameters

customer_idstringRequired

Request

This endpoint expects an object.

namestringRequired

strategyenumRequired

Allowed values:

descriptionstring or nullOptional

Optional free-text description

is_defaultbooleanOptional

allowed_providerslist of stringsOptional

allowed_modelslist of stringsOptional

priority_orderlist of objectsOptional

Response

Successful Response

idstring

namestring

descriptionstring or null

Optional free-text description

strategyenum

is_defaultboolean

Used when a request names no explicit policy.

allowed_providerslist of strings or null

allowed_modelslist of strings or null

priority_orderlist of objects or null

created_atdatetime

modified_atdatetime