Routing policies

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 by a cost, quality, or latency axis. 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}`
`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>"