Create Blocklist Rule
Create a rule that blocks or pins models and providers for customers, or for everyone. An organization can have up to 100 rules; changes apply to new requests within seconds.
Authentication
A management key (mgmt_...), sent as Authorization: Bearer <key>. Reading /v1/routing-policies also accepts the organization’s gateway API keys; writing there needs a management key.
Request
Values of the X-Customer-ID request header the rule applies to. Empty matches every customer. Empty strings are dropped. A block rule needs at least one non-empty list.
Full model ids, like openai/gpt-5.5. Empty strings are dropped. A block rule needs at least one non-empty list.
Model providers, the prefix of a model id, like anthropic. With models empty too, matches every model. Empty strings are dropped. A block rule needs at least one non-empty list.
block denies a request when its customer matches and its model or provider matches. pin lets the listed customers use only the listed providers and models, and needs customer_ids plus providers or models. A block always wins over a pin.
Response
Values of the X-Customer-ID request header the rule applies to. Empty matches every customer.
Full model ids, like openai/gpt-5.5.
Model providers, the prefix of a model id, like anthropic. With models empty too, matches every model.
block denies a request when its customer matches and its model or provider matches. pin lets the listed customers use only the listed providers and models, and needs customer_ids plus providers or models. A block always wins over a pin.