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
    }
  ],
  "axis": "COST",
  "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

axisenumOptional

Optimization axis for INTELLIGENT policies (the objective the router optimizes for). Must be omitted for PRIORITY. Defaults to COST when omitted.

Allowed values:

Response

Successful Response

idstringOptional

namestringOptional

descriptionstring or nullOptional

Optional free-text description

strategyenumOptional

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.

created_atdatetimeOptional

modified_atdatetimeOptional