Update routing policy

PATCH

https://api-gateway.merge.dev/v1/customers/:customer_id/routing-policies/:policy_id

PATCH

/v1/customers/:customer_id/routing-policies/:policy_id

$ curl -X PATCH https://api-gateway.merge.dev/v1/customers/customer_id/routing-policies/policy_id \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

200Updated

1 {
2   "id": "2a1b3c4d-5e6f-4708-9a0b-1c2d3e4f5a6b",
3   "name": "workflow-a",
4   "description": "Primary workflow routing",
5   "strategy": "PRIORITY",
6   "is_default": true,
7   "allowed_providers": [
8     "openai",
9     "anthropic"
10   ],
11   "allowed_models": [
12     "openai/gpt-5.5",
13     "anthropic/claude-opus-4-8"
14   ],
15   "priority_order": [
16     {
17       "model": "openai/gpt-5.5",
18       "priority": 1
19     },
20     {
21       "model": "anthropic/claude-opus-4-8",
22       "priority": 2
23     }
24   ],
25   "created_at": "2026-07-01T12:00:00Z",
26   "modified_at": "2026-07-01T12:00:00Z"
27 }

Authentication

AuthorizationBearer

Your production key sent as a bearer token.

Path parameters

customer_idstringRequired

policy_idstringRequired

Request

This endpoint expects an object.

namestringOptional

descriptionstring or nullOptional

Optional free-text description

strategyenumOptional

To change routing, send strategy plus its matching fields (all-or-nothing); otherwise the update is metadata-only

Allowed values:

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