---
schema_version: "newruntime-agent-readable-v0.2"
type: "capability_delta"
stable_id: "capability_delta:claude-apps-gateway-adds-group-level-upstream-routing-and-pooled"
slug: "claude-apps-gateway-adds-group-level-upstream-routing-and-pooled"
title: "Claude apps gateway adds group-level upstream routing and pooled budgets"
description: "The Claude apps gateway can restrict upstreams to listed IdP groups and give a group one shared monthly budget. Builders can now control both team access and collective spending."
retrieval_nugget: "The Claude apps gateway can restrict upstreams to listed IdP groups and give a group one shared monthly budget. Builders can now control both team access and collective spending."
status: "published"
observed_at: "2026-10-31"
record_date: "2026-10-31"
date_kind: "observed_at"
before_capability: "Spend limits applied to individual members; group-restricted upstream routing and pooled group budgets were not available through these settings."
enabling_change: "Version 2.1.314 adds optional IdP group lists to upstreams, including failover. Version 2.1.316 adds pooled_budget to the spend limits admin API."
after_capability: "Administrators can restrict upstream access by group and impose a shared monthly group budget alongside each member's individual limit."
human_consequence: "Administrators can allocate shared spending capacity and upstream access at the team level rather than managing only individual limits."
verification_level: "source-inspected"
buildability_class: "B4"
bottleneck: "Configuration still requires group membership and spend-limit administration; the entries do not explain how routing groups map to budget groups."
related_shift: "compute-backed-ai-contracts"
related_posts: []
topics: []
source_urls: ["https://github.com/anthropics/claude-code/releases/tag/v2.1.314","https://github.com/anthropics/claude-code/releases/tag/v2.1.316"]
featured: false
supporting_evidence: [{"title":"claude-code 2.1.314 Claude Code 2.1.314","url":"https://github.com/anthropics/claude-code/releases/tag/v2.1.314","kind":"external","observed_at":"2026-10-30"},{"title":"claude-code 2.1.316 Claude Code 2.1.316","url":"https://github.com/anthropics/claude-code/releases/tag/v2.1.316","kind":"external","observed_at":"2026-10-31"}]
routes: {"html":"https://newruntime.com/deltas/claude-apps-gateway-adds-group-level-upstream-routing-and-pooled/","markdown":"https://newruntime.com/deltas/claude-apps-gateway-adds-group-level-upstream-routing-and-pooled.md","json":"https://newruntime.com/deltas/claude-apps-gateway-adds-group-level-upstream-routing-and-pooled.json"}
source_format: "knowledge-ledger"
published_at: "2026-11-17T05:08:11.198Z"
auto_created: true
editorial_provenance: {"desk":"knowledge-revision","provider":"codex","model":"gpt-6.1-sol","created_at":"2026-11-17T05:08:11.198Z","week_start":"2026-10-26","review":"auto-created from reviewed evidence; the owner may revise or retire it"}
---

# Claude apps gateway adds group-level upstream routing and pooled budgets

## Retrieval answer

The Claude apps gateway can restrict upstreams to listed IdP groups and give a group one shared monthly budget. Builders can now control both team access and collective spending.

## Capability change

- Before: Spend limits applied to individual members; group-restricted upstream routing and pooled group budgets were not available through these settings.
- Enabling change: Version 2.1.314 adds optional IdP group lists to upstreams, including failover. Version 2.1.316 adds pooled_budget to the spend limits admin API.
- After: Administrators can restrict upstream access by group and impose a shared monthly group budget alongside each member's individual limit.

Human consequence: Administrators can allocate shared spending capacity and upstream access at the team level rather than managing only individual limits.

Bottleneck: Configuration still requires group membership and spend-limit administration; the entries do not explain how routing groups map to budget groups.

Buildability: B4. Verification: source-inspected. Related shift: [compute-backed-ai-contracts](https://newruntime.com/shifts/compute-backed-ai-contracts/).

Two releases add complementary group-level controls: upstream eligibility that also applies during failover, and a shared monthly budget layered over individual limits.

Builders can configure team-specific upstream access and pooled spending allowances. This changes collective resource allocation, rather than merely changing prices or identifying individual users.

Watch the relationship between IdP routing groups and budget groups: the entries do not establish a common mapping or describe what happens when a pooled budget is exhausted.

Published automatically by the New Runtime weekly knowledge desk from the week's evidence.

## Supporting evidence

- [claude-code 2.1.314 Claude Code 2.1.314](https://github.com/anthropics/claude-code/releases/tag/v2.1.314) (external, 2026-10-30)
- [claude-code 2.1.316 Claude Code 2.1.316](https://github.com/anthropics/claude-code/releases/tag/v2.1.316) (external, 2026-10-31)

## Provenance

Auto-created by the New Runtime weekly knowledge desk on 2026-11-17 from evidence reviewed in the week of 2026-10-26. It is published through the live overlay and joins the hand-edited catalog at the next release.
