NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #164 most downloaded on PyPI
The official Python library for the anthropic API
Latest stable
2.12.0
Last release 2 days ago
20 Nov 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
243 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
api: add the image_dimensions_too_large error code
bedrock: send the user profile ID in the request body
Amazon Bedrock reads user_profile_id from the request body and ignores the anthropic-user-profile-id header, so a profile ID given to AnthropicBedrock or AsyncAnthropicBedrock was not applied. Both clients now move it into the body of Messages requests and no longer send the header. A user_profile_id already in the body takes priority over the header.
Some models on Bedrock do not support user profiles. A request to one of them with a profile ID now fails with a 400 error; before, the ID was ignored. Leave the ID off requests to those models.
api: add Claude Code managed settings to the Admin API
client: encode spaces in query strings as %20
The AWS SigV4 signature of a request now matches its query string when a parameter contains a space.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
internal: don't report moved classes as breaking changes
api: rename error data models, deprecating the old names
docs: clarify which AWS KMS keys a workspace can use on Claude Platform on AWS
docs: clarify which credential work get, update and list accept
docs: clarify which uploads a plugin pin holds back
docs: note that a plugin scan's reason also covers errored scans
content_scan.reason on an errored scan now says why there is no verdict. It is not a security finding, so code that treats any reason as a concern should also check status.
internal: don't report moved classes as breaking changes
api: deprecate old beta header values
credentials: write the credentials file on Windows with Python 3.12 and earlier
tools: compare directory names exactly when confining file tool and upload paths on Windows
tools: fully resolve file tool paths that pass through a dangling symlink
tools: ignore ripgrep config files in the agent toolset's grep tool
tools: keep an existing skill directory when the download or extraction that would replace it fails
tools: keep the session tool runner's max_idle countdown running when a session thread terminates
If the runner fails to read the session's event history after a reconnect, a termination that then arrives on the event stream still cancels the countdown, until the next idle or successful read.
tools: leave symlinks that point outside /memories out of listings
tools: look for ripgrep only in absolute PATH entries in the agent toolset's grep tool
The tool no longer runs an rg from a relative or empty PATH entry or, on Windows, from the current directory. On Windows it looks for rg.exe, so an rg.cmd, rg.bat or rg.com is no longer used. With no other rg on PATH, the tool uses its built-in search.
tools: pass over an rg inside the directories the agent toolset's file tools can write
grep passes over an rg that resolves to somewhere inside workdir or allowed_roots, whatever the letter case of the names. It uses the next rg on PATH, or the built-in search when there is none. With a workdir that holds every rg on the host, such as /, every search is a built-in search. rg no longer gets the ANTHROPIC_* variables of the process, like the shell of bash.
tools: read memory files only through the path that was validated
tools: read only regular files in the grep tool's built-in search
The built-in search of grep passes over a FIFO or a device in the directory it walks, as ripgrep does. Reading one could block the search, and the event loop with it, forever.
tools: stop EnvironmentWorker from running tools for a terminated session
For a terminated session, the worker now force-stops the work item right after it retrieves the session, before it downloads skills or memory stores. It no longer raises SessionMemoryError for such a session. The API reports an archived session as terminated.
tools: stop the grep tool after 30 seconds of CPU time when ripgrep is not installed
tools: stop the session tool runner from running the tool calls of a terminated session thread
The runner also no longer yields these calls, including a denied call (confirmation="deny") and a call to a tool that it does not own. The one exception is a call whose tool is already running when the thread terminates: the runner yields it with posted=False and posts no result.
api: deprecate old beta header values
The API still accepts these values, but a later release removes them from the SDKs. Delete prompt-caching-2024-07-31, pdfs-2024-09-25, token-counting-2024-11-01, token-efficient-tools-2025-02-19, extended-cache-ttl-2025-04-11, cache-diagnosis-2026-04-07 and ce-user-management-2026-07-13 from your requests. files-api-2025-04-14 and skills-2025-10-02 select the beta response shapes, so follow the Files API and Skills migration guides before you delete them.
In C#, the AnthropicBeta enum's members have new numbers, so code compiled against an earlier SDK version sends a different beta value, with no error, until you rebuild it.
api: stop sending an old beta header on batch requests
beta.messages.batches no longer sends message-batches-2024-09-24, which the API doesn't need. If your client sets a default anthropic-beta header, these requests now send it, where in some SDKs the old value replaced it. The API still accepts the old value. If you set it yourself, delete it: a later release removes it from the SDKs.
docs: add an example value for the workspace name
docs: clarify when the auto permission policy denies a tool call
docs: clarify which workspaces an external key can be attached to
docs: recommend multiagent_20261001 over the coordinator type
docs: say when organization_id is required on plugin reads
tests: let idle test workers take queued tests
api: add Claude Tag metrics to the analytics summaries and users reports
api: accept user_profile.program_status_updated on organization webhook endpoints
api: add error code for ramp limit errors
api: add error details types and new error type values
/model//invokespeedapi: add GA methods for analytics, spend limits and RBAC
api: add Claude Tag endpoints for Claude Enterprise organizations
await from the async tool_runner examplesapi: add support for message threads
append_messages(), and keep the current reply out of the set_messages_params() callbackset_messages_params() gives tools as definitions, and stop running one it takes out of toolsset_messages_params() callback of a tool runner its tools as definitions againbetas, user_profile_id and workspace_id when set_messages_params() leaves them outapi: add enforcement status, actions and filter to user profiles
api: add support for new API version 2026-10-21
api: add org webhook endpoints and user profile enforcement events
api: add data_refreshed_at and has_more to analytics report pages
ci: speed up breaking change detection
api: add execution_identity to Managed Agents agents
api: add execution_identity to Managed Agents agents
api: add organization_type_not_supported error to spend limit lists
api: add telemetry destination test endpoint
api: add telemetry destinations to the Admin API
client: add native support for OpenTelemetry tracing
If your app registers a global tracer provider, the SDK will create spans with it after upgrading, and they'll be exported with the rest of your traces. Requests will also get trace context headers from the global propagator. To disable, pass open_telemetry=False to the client or set ANTHROPIC_OPEN_TELEMETRY=false. Learn more in the documentation.
api: add types for the Chat and Cowork unified analytics metrics
ci: check that pull requests update the changelog
api: add display_name to RBAC roles and deprecate name
Full Changelog: v1.11.0...v1.12.0
api: add list spend limits endpoint
Full Changelog: v1.10.0...v1.11.0
api: add a refusal stop reason and stop_details to Managed Agents session idle events
Full Changelog: v1.9.0...v1.10.0
transport object to Tunnel and return the one-time relay token in the create response (88718ff)api: add between_tools thinking type
Full Changelog: v1.8.0...v1.9.0
api: add support for claude-opus-5-5, inline tool definitions and MCP tool-list pinning (beta)
Full Changelog: v1.7.0...v1.8.0
api: add group with display_name to rate limits, deprecate group_type
Full Changelog: v1.6.0...v1.7.0
X | Y union types when parsing responses (b366fa5)X | Y fields with unknown data (30ebd69)api: add auto mode tool permissions for Managed Agents
Full Changelog: v1.5.0...v1.6.0
client: keep the idempotency_key request option as a deprecated no-op
Full Changelog: v1.4.0...v1.5.0
api: add Claude Tag category and user breakdowns to usage reports
Full Changelog: v1.3.0...v1.4.0
api: beta user profiles: add external_user_onboarded_at, remove relationship in favor of access_type
Full Changelog: v1.2.0...v1.3.0
api: beta files/skills namespaces use GA shapes; drop dated beta header pins
Full Changelog: v1.1.0...v1.2.0
unwrap() (0baa902)Full Changelog: v1.1.0...v1.2.0
api: beta files/skills namespaces use GA shapes; drop dated beta header pins (9df4565)
The beta Files and Skills namespaces (client.beta.files, client.beta.skills) no longer send the files-api-2025-04-14 / skills-2025-10-02 headers and return the same shapes as client.files / client.skills (with Beta-prefixed type names under anthropic.types.beta). Requests that still send those headers on raw HTTP keep receiving the beta shapes.
Changes in the beta namespaces:
client.beta.skills.delete() now deletes a Skill together with all of its versions (previously refused while any version existed). It returns BetaDeletedSkill (was SkillDeleteResponse).BetaSkill (container skill reference with skill_id, type, version) is renamed BetaContainerSkill; the request-side BetaSkillParams keeps its name. BetaSkill now names the Skill object returned by client.beta.skills.create() / retrieve() / list() (replacing SkillCreateResponse / SkillRetrieveResponse / SkillListResponse), and skill versions are BetaSkillVersion / BetaDeletedSkillVersion (replacing Version*Response).client.beta.files.list() returns SyncPageCursor[BetaFileMetadata] / AsyncPageCursor[BetaFileMetadata] (with data / next_page) and paginates with page= / ids= (was SyncPage / AsyncPage with data, has_more, first_id, last_id and before_id= / after_id=); iterating the result for auto-pagination is unchanged. BetaSkill uses display_name (was display_title, also the create() keyword) and latest_version_id (was latest_version), and BetaSkillVersion is addressed by its skver_… id (the Unix-timestamp version field is gone).Migration guides: Migrate from files-api-2025-04-14 · Migrate from skills-2025-10-02
unwrap() (0baa902)api: add updates thinking display mode (beta)
Full Changelog: v1.0.0...v1.1.0
updates thinking display mode (beta) (eb4a73f)latest support and memory version retention (a754f3b)import httpx2 directly instead of aliasing as httpx (628d789)client: upgrade to httpx2 and some minor breaking changes. See MIGRATION.md for details
Full Changelog: v0.125.0...v1.0.0
output_format= on the parse/stream/tool_runner helpers (59bf261)api: managed agents web search config and self hosted sandbox memory
Full Changelog: v0.124.0...v0.125.0
api: Files and Skills APIs are now GA; add computer use and browser use toolsets
Full Changelog: v0.123.0...v0.124.0
api: additions to files and memory stores
Full Changelog: v0.122.0...v0.123.0
api: add output_behavior to dream creation (create a new memory store or update the input store in place)
Full Changelog: v0.121.0...v0.122.0
api: add mid-conversation-tool-changes-2026-07-01 beta
Full Changelog: v0.120.2...v0.121.0
mid-conversation-tool-changes-2026-07-01 beta (c7d1531)mcp: support mcp sdk v2 alongside v1
## 0.120.1 (2026-07-28) Full Changelog: v0.120.0...v0.120.1 ### Bug Fixes * mcp: pin mcp extra to <2
api: add tool addition/removal blocks and tool_change events
api: add new stop reason 'model_context_window_exceeded'
Full Changelog: v0.118.0...v0.119.0
api: add support for Managed Agents model effort, initial session events, and threads delta streaming
Full Changelog: v0.117.1...v0.118.0
aws: handle credentials correctly when using AnthropicAWS.copy()
Full Changelog: v0.117.0...v0.117.1
api: add support for MCP Tunnels
Full Changelog: v0.116.0...v0.117.0
api: add agent-memory-2026-07-22 beta header
Full Changelog: v0.115.1...v0.116.0
api: remove some nonfunctional types from the SDKs
Full Changelog: v0.115.0...v0.115.1
api: add support for Managed Agents event delta streaming, agent overrides, reverse pagination, vault credential injection scoping, and agent and depl
Full Changelog: v0.114.0...v0.115.0
api: add support for claude-sonnet-5
Full Changelog: v0.113.0...v0.114.0
api: add support for 20260318 web fetch and support tools
Full Changelog: v0.112.0...v0.113.0
client: add support for system.message streaming events
Full Changelog: v0.111.0...v0.112.0
helpers: tag refusal-fallback middleware requests with fallback-refusal-middleware
api: add support for new code_execution_20260120 tool
Full Changelog: v0.109.2...v0.110.0
api: remove retired models from API and SDKs
Full Changelog: v0.109.1...v0.109.2
api: add frontier_llm refusal category
Full Changelog: v0.109.0...v0.109.1
frontier_llm refusal category (d3a806b)api: add support for Managed Agents deployments and environment variable credentials
Full Changelog: v0.108.0...v0.109.0
api: add support for claude-mythos-5 and claude-fable-5, with support for server-side fallbacks on refusal
foundry: send x-api-key header for API-key auth (#62) (1338141), closes #1661
api: small updates to Managed Agents types
Full Changelog: v0.106.0...v0.107.0
api: mark Claude Opus 4.1 as deprecated
Full Changelog: v0.105.2...v0.106.0
## 0.105.2 (2026-05-29) Full Changelog: v0.105.1...v0.105.2
Full Changelog: v0.105.1...v0.105.2
One column per quarter.