apiwatch

All changes / Anthropic

Breaking rest

On API version 2026-10-21 (opt-in, released October 21, 2026), Admin API and Claude Enterprise Analytics API responses no longer include the old names of renamed fields (roles, group_id, name, group_type, workspace_id, actor.email, summaries)

Took effect · Admin API (RBAC groups, RBAC group members, RBAC roles, rate limits, API keys) and Claude Enterprise Analytics API responses on API version 2026-10-21

Reviewed against the vendor source on Oct 23, 2026 (AI-assisted review). Key facts are re-checked against the source daily.

What changes

Opt-in: the change applies to requests sent with anthropic-version: 2026-10-21, by hand or through the new SDK majors that send it by default (Python 2.0.0, TypeScript 1.0.0, Go 2.0.0, Java 3.0.0, C# 13.0.0, PHP 1.0.0, Ruby 2.0.0, ant CLI 2.0.0). Admin API: RBAC groups roles -> role_ids; RBAC group members group_id -> rbac_group_id; RBAC roles name -> display_name; organization and workspace rate limits group_type -> group.type; API keys workspace_id -> scope, with different values: a key bound to a workspace, including the Default Workspace, has scope.workspace_id set to that workspace's real ID, and an all-workspaces key has scope {"type": "organization"} with no workspace_id (on 2023-06-01 both were a null workspace_id). Claude Enterprise Analytics API: per-user usage and cost reports actor.email -> actor.email_address; activity summaries summaries -> data. The group_type query parameter on the rate-limit list endpoints and the workspace_id filter on the API key list endpoint are unchanged.

Breaking: Calls fail after this date.

What to do

Before moving to 2026-10-21 (or the new SDK major), read the new names: role_ids (RBAC groups), rbac_group_id (RBAC group members), display_name (RBAC roles), group.type (rate limits), actor.email_address (usage and cost reports) and data (activity summaries). For API keys read scope instead of workspace_id; if you treated a null workspace_id as the Default Workspace, compare scope.workspace_id with the Default Workspace's ID (List Workspaces with include_default=true, the workspace named "Default"), and treat scope {"type": "organization"} as an all-workspaces key. Keep sending the group_type query parameter and workspace_id filter as before.

Strings to search for

["roles"].get("roles").roles["group_id"].get("group_id").group_id["group_type"].get("group_type").group_type["workspace_id"].get("workspace_id").workspace_idactor.email["actor"]["email"]["summaries"].get("summaries").summariesactor["email"]actor.get("email")"actor", {}).get("email")actor?.email

Not affected (matches inside these are ignored): scope.workspace_id, ["scope"]["workspace_id"], scope?.workspace_id, scope["workspace_id"], scope.get("workspace_id"), scope"].get("workspace_id"), "scope", {}).get("workspace_id"), analytics.summaries

Counts only in files that mention organizations/rbac_groups or organizations/rbac_roles or organizations/rate_limits or organizations/workspaces + rate_limits or organizations/api_keys or analytics/user_usage_report or analytics/user_cost_report or analytics/summaries or organization.rbac_groups or organization.rbacGroups or organization.rbac_roles or organization.rbacRoles or organization.rate_limits or organization.rateLimits or workspaces.rate_limits or workspaces.rateLimits or organization.api_keys or organization.apiKeys or analytics.user_usage_report or analytics.userUsageReport or analytics.user_cost_report or analytics.userCostReport or analytics.summaries; repos that depend on anthropic 2.x (pypi) or @anthropic-ai/sdk 1.x (npm) or anthropic 2.x (rubygems) or anthropic-ai/sdk 1.x (packagist); or repos that mention anthropic-sdk-go/v2 or anthropic-cli/v2 or com.anthropic:anthropic-java:3. or include="anthropic" version="13. or anthropic-version + 2026-10-21 (including dependency manifests).

Source

https://platform.claude.com/docs/en/api/migration-2026-10-21.md