Routing policies

Decide how a customer's requests pick a model

A routing policy decides how a customer’s requests pick a model. PRIORITY tries a ranked list in order, falling back to the next model if one fails; INTELLIGENT picks per request from an allowed set, optimizing for the policy’s axis (COST, PERFORMANCE, or CAPABILITY). A customer’s default policy applies when a request names no explicit routing_policy_id.

Path: /v1/customers/{customer_id}/routing-policies.

Fields

Field	Description	Type
`id`	Merge UUID	string
`name`	Policy name	string
`description`	Optional free-text description	string, nullable
`strategy`	`PRIORITY` or `INTELLIGENT`	enum
`is_default`	Used when a request names no explicit policy	boolean
`allowed_providers`	Provider slugs (`INTELLIGENT` only, else null)	list
`allowed_models`	Model slugs (`INTELLIGENT` only, else null)	list
`priority_order`	Ordered fallback models (`PRIORITY` only, else null)	list of `{model, priority}`
`axis`	Optimization axis the router optimizes for: `COST`, `PERFORMANCE`, or `CAPABILITY` (`INTELLIGENT` only, else null; defaults to `COST`)	enum, nullable
`created_at`, `modified_at`	Timestamps	datetime

Add a routing policy

PRIORITY tries priority_order in order; INTELLIGENT picks per request from the allowed set.

curl -X POST https://api-gateway.merge.dev/v1/customers/{customer_id}/routing-policies \
  -H "Authorization: Bearer mg_<your_production_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "workflow-a",
    "description": "Primary workflow routing",
    "strategy": "PRIORITY",
    "is_default": true,
    "priority_order": [
      { "model": "openai/gpt-5.5", "priority": 1 },
      { "model": "anthropic/claude-opus-4-8", "priority": 2 }
    ]
  }'

Remove a policy

Delete a policy to stop routing through it. Deleting the default leaves the customer with no default: requests naming only customer fall back to the org default.

Delete

curl -X DELETE https://api-gateway.merge.dev/v1/customers/{customer_id}/routing-policies/{policy_id} \
  -H "Authorization: Bearer mg_<your_production_key>"