Skip to content
← Back to release · 2.1.295
New features / v2.1.295

Restrict gateway upstreams by model

CHANGELOG · original

Added an optional models list to every Claude apps gateway upstream: only the listed models are sent there, on failover too, and one * in an entry is a wildcard
Open official changelog ↗

Documentation

Documentation excerpt

models

The models block is an optional admin-curated model list, served at /v1/models and used to translate model IDs per upstream. It is required for non-US Amazon Bedrock regions, Amazon Bedrock provisioned-throughput ARNs, and Microsoft Foundry deployment names.

auto_include_builtin_models: true   # false: expose only the list below
models:
  - id: claude-opus-4-8
    label: Claude Opus 4.8
    # description: optional text shown in clients that surface it
    upstream_model:
      anthropic: claude-opus-4-8
      bedrock: us.anthropic.claude-opus-4-8   # or an inference-profile ARN
      foundry: your-opus-deployment-name

Each key under upstream_model must match the name of a configured upstream, which defaults to the provider name. A key that matches no upstream fails boot, so omit the lines for providers you don't use.

To let developers use the fable alias with auto_include_builtin_models: false, add a claude-fable-5 entry to models. That's the ID the fable alias resolves to for developers signed in to the gateway. Without it, their messages fail with an error that starts with API Error: 400 model claude-fable-5 is not in the operator's model allowlist.

Documentation snapshot · 2026-11-20

Change details