Source: raw/anthropic-watch-anthropic-sdk-python-tag-v{1-11-0..2-1-0}.md and raw/anthropic-watch-anthropic-sdk-typescript-tag-{sdk-v0-136-0,sdk-v0-137-0,sdk-v1-0-0,sdk-v1-1-0,aws-sdk-v1-0-0,bedrock-sdk-v1-0-0,foundry-sdk-v1-0-0,google-cloud-sdk-v1-0-0,vertex-sdk-v0-22-0,vertex-sdk-v1-0-0}.md (Stainless-generated GitHub releases, 2026-09-30 → 2026-10-21), plus anthropics/skills commits 683bc88e, 9d630808, dbd4588f and anthropics/anthropic-cookbook commits 39cd5a7a, b2b0aa1f, a162e018, 9c1e493d. Extended 2026-11-01 with Python v2.2.0–v2.3.0, TypeScript sdk-v1.2.0–v1.3.0 and the cloud packages’ v1.1.x releases (all 2026-10-23), skills commit ca45fc49 and cookbook commits bfe50e59 and c43f56d0.
Project: anthropics/anthropic-sdk-python, anthropics/anthropic-sdk-typescript · URL: https://github.com/anthropics/anthropic-sdk-python/releases · Version: Python v1.11.0 → v2.3.0; TypeScript sdk-v0.136.0 → sdk-v1.3.0 (plus aws, bedrock, foundry, google-cloud and vertex packages at v1.0.0 → v1.1.x)
October ended with both SDKs taking a major version on the same day. On 2026-10-21 Python v2.0.0, TypeScript sdk-v1.0.0 and all five TypeScript cloud packages shipped as breaking releases for the new API version 2026-10-21. Before that, three weeks of minor releases added claude-haiku-5-5, native OpenTelemetry tracing in the Python client, a speed parameter on Messages, and Managed Agents multiagent configuration. The cookbook and the bundled claude-api skill show what the new API version is for: the multiagent_20261001 Managed Agents type with dynamic workflows.
Key Takeaways
- Major versions on 2026-10-21 for API version
2026-10-21. Python v2.0.0 and TypeScript sdk-v1.0.0 mark “add support for new API version 2026-10-21” as a breaking change; aws-sdk, bedrock-sdk, foundry-sdk, google-cloud-sdk and vertex-sdk each went to v1.0.0 with the same single breaking entry. The changelogs do not list what changed in request or response shapes. On the Claude Code side,/claude-api api-version(v2.1.307) migrates bundled API code to the same version: see What’s New — Week 43. - This answers “will TypeScript follow Python to 1.0?”, the open question in the August–September article: it did, on 2026-10-21, while Python moved to 2.0.
claude-haiku-5-5landed in Python v1.12.0 (2026-10-07), the same day as Claude Haiku 5.5’s API release, together with typed computer and browser toolset tool calls. Theclaude-apiskill made Haiku 5.5 its current Haiku two days later (skills9d630808).- Sonnet 4.5 is deprecated in the client (Python v1.11.0, 2026-09-30).
- Native OpenTelemetry in the Python client (v1.14.0, 2026-10-15). If your app registers a global tracer provider, the SDK starts emitting spans into it after the upgrade and adds trace-context headers from the global propagator. Check this before upgrading, because spans appear without a code change. A new cookbook notebook walks through it: Messages API attributes, streaming, the tool runner, a Managed Agents session, OTLP export and a Console destination for the API’s own spans (cookbook
b2b0aa1f). Telemetry destinations also arrived in the Admin API (v1.14.0). - A
speedparameter on Messages withusage.speedreporting (Python v1.15.0). The changelog notes “some models need a beta header to use speed” and does not say which. - Managed Agents moved toward multiagent orchestration. Python v1.13.0 added workflows, multiagent configuration and thread status filtering; v1.14.0 added
execution_identityon agents. The cookbook’s plan-big-execute-small recipe now setsmultiagent_20261001: the small worker is listed undersubagents.predefined_agents,subagents.inline_agentsandworkflowsare disabled so every task goes to that worker, and the orchestrator delegates withcreate_agent,send_to_agentandlist_agentswhile workers report withsend_to_parent(cookbook39cd5a7a, SDK flooranthropic>=1.13.0). See Managed Agents. - Message threads and Claude Tag endpoints (2026-10-23). Two days after the major versions, Python v2.2.0 and TypeScript sdk-v1.2.0 added support for message threads and usage and cost reports by dimension (older reports marked legacy); every TypeScript cloud package took a v1.1.0 whose only feature is message threads. Python v2.3.0 and TypeScript sdk-v1.3.0, later the same day, added Claude Tag endpoints for Claude Enterprise organizations. The changelogs don’t describe what a message thread is.
- Admin and governance surface keeps growing: a list-spend-limits endpoint (v1.11.0, early access) with
workspace_idandusage_tierfilters in v2.0.0; workspace rate-limit updates (v1.16.0); User Profiles generally available (v1.16.0) with enforcement status, actions and events (v1.17.0, v2.1.0); org webhook endpoints (v1.17.0); and analytics types for the Chat and Cowork unified metrics (v1.13.0).
Python v1.11.0 → v2.1.0
| Version | Date | Highlights |
|---|---|---|
| v1.11.0 | 2026-09-30 | List spend limits endpoint; Sonnet 4.5 deprecated in the client |
| v1.12.0 | 2026-10-07 | claude-haiku-5-5; typed computer and browser toolset tool calls; disabled thinking type in model capabilities; lifecycle stage fields and filter on /v1/models; line on model objects; url_sources for the Managed Agents web_fetch tool; RBAC role display_name (deprecates name) |
| v1.12.1 | 2026-10-08 | Docs: listing Console spend limits is in early access |
| v1.13.0 | 2026-10-09 | Chat and Cowork unified analytics metric types; Managed Agents workflows, multiagent configuration and thread status filtering |
| v1.14.0 | 2026-10-15 | Native OpenTelemetry tracing; Managed Agents execution_identity; Admin API telemetry destinations and a test endpoint; stream helpers pass unknown event types through |
| v1.15.0 | 2026-10-15 | speed parameter and usage.speed on Messages; between_tools thinking type in model capabilities; a Console organization’s usage-tier cap returned as a read-only spend limit |
| v1.16.0 | 2026-10-20 | User Profiles GA; workspace rate-limit updates in the Admin API; data_refreshed_at and has_more on analytics pages; Google Cloud client on v1 endpoints plus an organization endpoint |
| v1.17.0 | 2026-10-20 | Org webhook endpoints and user-profile enforcement events; RBAC Group owner-access error codes; Bedrock/Mantle and Google Cloud clients keep workspace IDs set in default_headers |
| v2.0.0 | 2026-10-21 | BREAKING: API version 2026-10-21; workspace_id filter and usage_tier scope on list spend limits |
| v2.1.0 | 2026-10-21 | Enforcement status, actions and filter on user profiles |
| v2.2.0 | 2026-10-23 | Message threads; usage and cost reports by dimension (older reports marked legacy); tool-runner fixes: append_messages() leaves history to the caller, and set_messages_params() keeps function tools, betas, user_profile_id and workspace_id |
| v2.3.0 | 2026-10-23 | Claude Tag endpoints for Claude Enterprise organizations; Google Cloud user-profile requests go to the organization endpoint; endpoint path query params no longer hardcoded |
TypeScript
- sdk-v0.136.0 (2026-10-20) mirrors Python v1.16.0, adds “accept every tool definition field in the tool helpers”, treats
x-amz-security-tokenas a sensitive header, and keeps$sequences literal in the memory tool’sstr_replace. - sdk-v0.137.0 (2026-10-20) mirrors Python v1.17.0.
- sdk-v1.0.0 (2026-10-21) is the breaking API-version release (mirrors Python v2.0.0); sdk-v1.1.0 mirrors Python v2.1.0.
- sdk-v1.2.0 (2026-10-23) mirrors Python v2.2.0 (message threads, reports by dimension) and fixes the tool runner copying the messages it is created with, and its behaviour after
setMessagesParams()orpushMessages()in the loop body. sdk-v1.3.0 (same day) mirrors Python v2.3.0 (Claude Tag endpoints) and links long-request error messages to the SDK documentation. - Cloud packages v1.1.x (2026-10-23):
aws-sdk,bedrock-sdk,foundry-sdk,google-cloud-sdkandvertex-sdkv1.1.0 each add message threads;aws-sdkv1.1.1 is a test-only chore;google-cloud-sdkv1.1.1 sends user-profile routes to the organization endpoint and updates the product name. - Cloud packages:
aws-sdk,bedrock-sdk,foundry-sdk,google-cloud-sdkandvertex-sdkall reached v1.0.0 on 2026-10-21.vertex-sdk-v0.22.0(the day before) throws anAnthropicErrorwhenuserProfilesis read onAnthropicVertex, which does not serve those endpoints.
The claude-api skill and the cookbook
-
Haiku 5.5 as the current Haiku, plus Managed Agents and preserved-thinking fixes (skills
9d630808, 2026-10-09). -
Dynamic workflows (skills
dbd4588f, 2026-10-09): the bundled skill gained the Managed Agents dynamic-workflows guidance, four dynamic-workflow quickstart templates, and rules for web tools under limited networking. -
managed-agents-onboardfrom a quickstart name or URL (skills683bc88e, 2026-10-05). -
Cookbook moves: an agent security review cookbook for Managed Agents (
a162e018, 2026-10-17); the self-hosted sandbox variants moved toclaude-quickstarts(9c1e493d, 2026-10-10); the plan-big-execute-small recipe renamed its “coordinator” to “orchestrator” (env varCOOKBOOK_ORCHESTRATOR_MODEL, with the oldCOOKBOOK_COORDINATOR_MODELstill read) and notes that its quoted figures predate the move (39cd5a7a). -
Cookbook defaults moved to the 5.5 generation: notebooks now default to Opus 5.5, Sonnet 5.5 and Fable 5.1 (
bfe50e59, 2026-10-24), and Claude Haiku 5.5 became the default Haiku (c43f56d0, 2026-10-29). -
mcp-builderskill teaches MCP TypeScript SDK v2 (skillsca45fc49, 2026-10-28). A newreference/node_mcp_server_v2.mdcovers@modelcontextprotocol/serverwith a server factory, a fetch-based API helper, tool design guidance, one complete stdio + HTTP example, bearer auth, resources and prompts, and a self-check script that verifies the built server. When a project already depends on@modelcontextprotocol/sdk(v1), the agent tells the user once that v2 is the current stable release, that v1 gets only bug and security fixes, and how to migrate with the codemod, then carries on with v1 unless asked to migrate. See MCP.
Try It
- Before bumping to Python v2 / TypeScript v1, run the Claude Code
/claude-api api-versionmigration on any code that pins an API version, then test: the changelogs do not list the breaking shape changes. - If you use OpenTelemetry in Python, decide whether you want SDK spans before upgrading past v1.14.0; they join your global tracer provider automatically.
- For a cheap worker pattern on Managed Agents, start from the updated plan-big-execute-small recipe (
multiagent_20261001, a predefined small-model subagent, inline agents disabled). - Pin
anthropic>=1.12.0for theclaude-haiku-5-5constant. - New MCP servers in TypeScript: ask Claude to use the
mcp-builderskill and target SDK v2 (@modelcontextprotocol/server); it now ships a self-check script for the built server.
Open Questions
- What exactly breaks in API version
2026-10-21? Neither SDK changelog lists request or response changes. The cookbook and the W43 digest tie it tomultiagent_20261001and dynamic workflows; whether non-agent Messages calls change is not stated. - Which models need a beta header for
speed, and what values does it take? - What does
between_toolsthinking do? Carried over from the August–September article; v1.15.0 adds it to model capabilities without describing it. - What is a “message thread” in the API, and how does it relate to Managed Agents threads? The v2.2.0 / sdk-v1.2.0 changelogs only say “add support for message threads”.
- Python v1.10.0 is not in these sources (v1.11.0’s changelog diffs against it).
Related
- Anthropic SDK Releases — August–September 2026 — the preceding article.
- Claude Haiku 5.5 —
claude-haiku-5-5. - What’s New — Week 43 —
/claude-api api-versionandmultiagent_20261001on the Claude Code side. - Managed Agents — multiagent configuration and workflows.
- Agent Observability — OpenTelemetry for agents.
- Claude Cookbooks — the notebooks referenced here.
- Anthropic SDK releases, November 2026 — the next batch: Admin API GA methods, typed error classes, ramp-limit codes.