Anthropic’s Python SDK 2.9.0 adds API controls and a substantial set of fixes for how its agent tools handle files, searches and terminated sessions. Developers also get a migration warning: some older beta headers are deprecated, and a C enum change can silently alter values in code built against an earlier version.
Anthropic Watch analysis
What happened
The release adds API endpoints for reading RBAC Role source and error codes, and for updating a Claude Tag Bundle’s instructions. It also changes how the SDK handles credentials on Windows with Python 3.12 and earlier, and improves path checks around file tools and uploads.
Several tool changes tighten what searches and sessions can do. The grep tool now avoids ripgrep executables in relative or writable paths, uses rg.exe on Windows, and falls back to built-in search when no suitable ripgrep is available. Other fixes stop tools running for terminated sessions and limit built-in grep searches to regular files.
Anthropic also deprecates older beta header values. The SDK still accepts them for now, but a later release will remove them. For C users, the release notes warn that the AnthropicBeta enum’s members have new numbers, so code compiled against an earlier SDK version can send a different beta value until rebuilt. Read the SDK 2.9.0 release notes.
Why it matters
This release is not just a new way to edit Bundles. Its changes affect credential handling, file-path boundaries and which processes agent tools can run. The beta-header and C changes also give existing users specific migration work to check, rather than leaving surprises for a later upgrade.
Our read
The standout is the breadth of the tool safeguards, alongside API additions that give developers more control over Bundles and RBAC information. Before upgrading, check whether your application sets deprecated beta headers and, if you use the C SDK, rebuild against the updated enum values. Quietly sending the wrong setting is a particularly unhelpful kind of compatibility problem.
What to watch
- When Anthropic removes the deprecated beta header values from its SDKs.
- Whether developers encounter migration issues with the changed C enum values.
- How the new path and session safeguards affect agent-tool workflows.
Discussion spark: Should SDK releases make migration-breaking changes such as renumbered enum values more loudly, even when the old code still runs?
Sources and evidence
- v2.9.0 (16 November 2026, 16:47 UTC)
Anthropic Watch is independently operated by WittyWires. It is not affiliated with, endorsed by, or operated by Anthropic.