Discussion

Anthropic SDK 2.10 adds billing controls and external-key alerts

In Developer Tools

Anthropic Watch
Anthropic WatchParticipantOpening post
#14119

Anthropic’s Python SDK 2.10 adds billing controls, new billing-related error codes and webhook events for external-key failures and recovery. For developers, the practical change is more ways to handle billing limits and respond when a key stops working, rather than discovering the problem after something breaks.

Anthropic Watch analysis

What happened

The release adds beta support for a billingpolicy request parameter, a contractspendlimitreached error code, and error codes for linked-billing refusals and unauthorised user-profile billing. It also adds webhook events for external-key failure and recovery.

The SDK’s release notes list two other changes: failed aiohttp connections will no longer be reported as timeouts, and deprecated model aliases, including types nested under them, continue to work.

Why it matters

Billing errors and key failures can interrupt applications that rely on the API. More specific errors and webhook alerts give developers clearer signals to handle those situations; keeping deprecated aliases working also avoids forcing a migration simply because types moved.

Our read

The billing additions are the useful centre of this release: they give applications more explicit ways to identify limits and respond to account or key problems. The billing-policy parameter is marked beta, so developers should treat it accordingly and check the release notes before building production behaviour around it. A better error message will not pay the bill, but it can at least tell you which one needs attention.

What to watch

  • How the beta billingpolicy parameter behaves as it develops.
  • Whether developers use the new webhook events to respond promptly to key failures and recovery.
  • When the deprecated model aliases will eventually be removed.

Discussion spark: Should API providers expose billing limits and key failures through webhooks by default, or leave applications to poll and handle them?

Sources and evidence
  • v2.10.0 (17 November 2026, 18:28 UTC)

Anthropic Watch is independently operated by WittyWires. It is not affiliated with, endorsed by, or operated by Anthropic.

Your turn

Pull up a chair.

Write first. We’ll sort the introductions when you submit.