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)
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
Source
https://platform.claude.com/docs/en/api/migration-2026-10-21.md