Sessions changedapi/beta/sessions
Nearest release: v2.1.300, published 6 hours before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+685added
Lines−0removed
From line
121
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits27to this page, all time
The whole hunk
from line 121, old and new numbered
/
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 121
121121
122122 - `"spend-limit-reads-2026-09-26"`
123123
124 - `"telemetry-destinations-2026-08-11"`
125
124126- `"anthropic-workspace-id": optional string`
125127
126128 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 1273
12711273
12721274 - `description: string or null`
12731275
1276 - `execution_identity: BetaManagedAgentsExecutionIdentity`
1277
1278 Execution principal snapshotted from the agent at session creation. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
1279
1280 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
1281
1282 An AWS IAM role principal as returned in API responses.
1283
1284 - `type: "aws_role"`
1285
1286 - `role_arn: string`
1287
1288 The IAM role's ARN.
1289
1290 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
1291
1292 The Anthropic-managed service account as returned in API responses.
1293
1294 - `type: "service_account"`
1295
12741296 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
12751297
12761298 - `type: "url"`
from line 1451
14291451
14301452 - `description: string or null`
14311453
1454 - `execution_identity: BetaManagedAgentsExecutionIdentity`
1455
1456 Execution principal snapshotted from the agent at session creation. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
1457
14321458 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
14331459
14341460 - `type: "url"`
from line 2001
19752001
19762002 - `description: string or null`
19772003
2004 - `execution_identity: BetaManagedAgentsExecutionIdentity`
2005
2006 Execution principal snapshotted from the agent at session creation. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
2007
19782008 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
19792009
19802010 - `model: BetaManagedAgentsModelConfig`
from line 2053
20232053
20242054 - `description: string or null`
20252055
2056 - `execution_identity: BetaManagedAgentsExecutionIdentity`
2057
2058 Execution principal snapshotted from the agent at session creation. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
2059
20262060 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
20272061
20282062 - `model: BetaManagedAgentsModelConfig`
from line 2429
23952429 "agent": {
23962430 "id": "agent_011CZkYpogX7uDKUyvBTophP",
23972431 "description": "A general-purpose starter agent.",
2432 "execution_identity": {
2433 "type": "service_account"
2434 },
23982435 "mcp_servers": [
23992436 {
24002437 "name": "example-mcp",
from line 2452
24152452 {
24162453 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
24172454 "description": "A focused research subagent.",
2455 "execution_identity": {
2456 "type": "service_account"
2457 },
24182458 "mcp_servers": [
24192459 {
24202460 "name": "example-mcp",
from line 2823
27832823
27842824 - `"spend-limit-reads-2026-09-26"`
27852825
2826 - `"telemetry-destinations-2026-08-11"`
2827
27862828- `"anthropic-workspace-id": optional string`
27872829
27882830 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 2851
28092851
28102852 - `description: string or null`
28112853
2854 - `execution_identity: BetaManagedAgentsExecutionIdentity`
2855
2856 Execution principal snapshotted from the agent at session creation. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
2857
2858 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
2859
2860 An AWS IAM role principal as returned in API responses.
2861
2862 - `type: "aws_role"`
2863
2864 - `role_arn: string`
2865
2866 The IAM role's ARN.
2867
2868 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
2869
2870 The Anthropic-managed service account as returned in API responses.
2871
2872 - `type: "service_account"`
2873
28122874 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
28132875
28142876 - `type: "url"`
from line 3029
29673029
29683030 - `description: string or null`
29693031
3032 - `execution_identity: BetaManagedAgentsExecutionIdentity`
3033
3034 Execution principal snapshotted from the agent at session creation. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
3035
29703036 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
29713037
29723038 - `type: "url"`
from line 3579
35133579
35143580 - `description: string or null`
35153581
3582 - `execution_identity: BetaManagedAgentsExecutionIdentity`
3583
3584 Execution principal snapshotted from the agent at session creation. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
3585
35163586 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
35173587
35183588 - `model: BetaManagedAgentsModelConfig`
from line 3631
35613631
35623632 - `description: string or null`
35633633
3634 - `execution_identity: BetaManagedAgentsExecutionIdentity`
3635
3636 Execution principal snapshotted from the agent at session creation. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
3637
35643638 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
35653639
35663640 - `model: BetaManagedAgentsModelConfig`
from line 4000
39264000 "agent": {
39274001 "id": "agent_011CZkYpogX7uDKUyvBTophP",
39284002 "description": "A general-purpose starter agent.",
4003 "execution_identity": {
4004 "type": "service_account"
4005 },
39294006 "mcp_servers": [
39304007 {
39314008 "name": "example-mcp",
from line 4023
39464023 {
39474024 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
39484025 "description": "A focused research subagent.",
4026 "execution_identity": {
4027 "type": "service_account"
4028 },
39494029 "mcp_servers": [
39504030 {
39514031 "name": "example-mcp",
from line 4316
42364316
42374317 - `"spend-limit-reads-2026-09-26"`
42384318
4319 - `"telemetry-destinations-2026-08-11"`
4320
42394321- `"anthropic-workspace-id": optional string`
42404322
42414323 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 4344
42624344
42634345 - `description: string or null`
42644346
4347 - `execution_identity: BetaManagedAgentsExecutionIdentity`
4348
4349 Execution principal snapshotted from the agent at session creation. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
4350
4351 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
4352
4353 An AWS IAM role principal as returned in API responses.
4354
4355 - `type: "aws_role"`
4356
4357 - `role_arn: string`
4358
4359 The IAM role's ARN.
4360
4361 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
4362
4363 The Anthropic-managed service account as returned in API responses.
4364
4365 - `type: "service_account"`
4366
42654367 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
42664368
42674369 - `type: "url"`
from line 4522
44204522
44214523 - `description: string or null`
44224524
4525 - `execution_identity: BetaManagedAgentsExecutionIdentity`
4526
4527 Execution principal snapshotted from the agent at session creation. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
4528
44234529 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
44244530
44254531 - `type: "url"`
from line 5072
49665072
49675073 - `description: string or null`
49685074
5075 - `execution_identity: BetaManagedAgentsExecutionIdentity`
5076
5077 Execution principal snapshotted from the agent at session creation. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
5078
49695079 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
49705080
49715081 - `model: BetaManagedAgentsModelConfig`
from line 5124
50145124
50155125 - `description: string or null`
50165126
5127 - `execution_identity: BetaManagedAgentsExecutionIdentity`
5128
5129 Execution principal snapshotted from the agent at session creation. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
5130
50175131 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
50185132
50195133 - `model: BetaManagedAgentsModelConfig`
from line 5483
53695483 "agent": {
53705484 "id": "agent_011CZkYpogX7uDKUyvBTophP",
53715485 "description": "A general-purpose starter agent.",
5486 "execution_identity": {
5487 "type": "service_account"
5488 },
53725489 "mcp_servers": [
53735490 {
53745491 "name": "example-mcp",
from line 5506
53895506 {
53905507 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
53915508 "description": "A focused research subagent.",
5509 "execution_identity": {
5510 "type": "service_account"
5511 },
53925512 "mcp_servers": [
53935513 {
53945514 "name": "example-mcp",
from line 5795
56755795
56765796 - `"spend-limit-reads-2026-09-26"`
56775797
5798 - `"telemetry-destinations-2026-08-11"`
5799
56785800- `"anthropic-workspace-id": optional string`
56795801
56805802 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 6405
62836405
62846406 - `description: string or null`
62856407
6408 - `execution_identity: BetaManagedAgentsExecutionIdentity`
6409
6410 Execution principal snapshotted from the agent at session creation. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
6411
6412 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
6413
6414 An AWS IAM role principal as returned in API responses.
6415
6416 - `type: "aws_role"`
6417
6418 - `role_arn: string`
6419
6420 The IAM role's ARN.
6421
6422 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
6423
6424 The Anthropic-managed service account as returned in API responses.
6425
6426 - `type: "service_account"`
6427
62866428 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
62876429
62886430 - `type: "url"`
from line 6583
64416583
64426584 - `description: string or null`
64436585
6586 - `execution_identity: BetaManagedAgentsExecutionIdentity`
6587
6588 Execution principal snapshotted from the agent at session creation. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
6589
64446590 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
64456591
64466592 - `type: "url"`
from line 7133
69877133
69887134 - `description: string or null`
69897135
7136 - `execution_identity: BetaManagedAgentsExecutionIdentity`
7137
7138 Execution principal snapshotted from the agent at session creation. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
7139
69907140 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
69917141
69927142 - `model: BetaManagedAgentsModelConfig`
from line 7185
70357185
70367186 - `description: string or null`
70377187
7188 - `execution_identity: BetaManagedAgentsExecutionIdentity`
7189
7190 Execution principal snapshotted from the agent at session creation. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
7191
70387192 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
70397193
70407194 - `model: BetaManagedAgentsModelConfig`
from line 7548
73947548 "agent": {
73957549 "id": "agent_011CZkYpogX7uDKUyvBTophP",
73967550 "description": "A general-purpose starter agent.",
7551 "execution_identity": {
7552 "type": "service_account"
7553 },
73977554 "mcp_servers": [
73987555 {
73997556 "name": "example-mcp",
from line 7571
74147571 {
74157572 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",
74167573 "description": "A focused research subagent.",
7574 "execution_identity": {
7575 "type": "service_account"
7576 },
74177577 "mcp_servers": [
74187578 {
74197579 "name": "example-mcp",
from line 7860
77007860
77017861 - `"spend-limit-reads-2026-09-26"`
77027862
7863 - `"telemetry-destinations-2026-08-11"`
7864
77037865- `"anthropic-workspace-id": optional string`
77047866
77057867 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 8017
78558017
78568018 - `"spend-limit-reads-2026-09-26"`
78578019
8020 - `"telemetry-destinations-2026-08-11"`
8021
78588022- `"anthropic-workspace-id": optional string`
78598023
78608024 Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
from line 8045
78818045
78828046 - `description: string or null`
78838047
8048 - `execution_identity: BetaManagedAgentsExecutionIdentity`
8049
8050 Execution principal snapshotted from the agent at session creation. Always present; `{"type": "service_account"}` when runs carry no customer-named principal.
8051
8052 - `BetaManagedAgentsAWSRoleExecutionIdentity object`
8053
8054 An AWS IAM role principal as returned in API responses.
8055
8056 - `type: "aws_role"`
8057
8058 - `role_arn: string`
8059
8060 The IAM role's ARN.
8061
8062 - `BetaManagedAgentsServiceAccountExecutionIdentity object`
8063
8064 The Anthropic-managed service account as returned in API responses.
8065
8066 - `type: "service_account"`
8067
78848068 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
78858069
78868070 - `type: "url"`
from line 8147
79638147
79648148 - `"claude-sonnet-4-5-20250929"`
79658149
7966 **Deprecated**: Will reach end-of-life on November 30, 2026. Please migrate to claude-sonnet-5-5. Visit https://docs.anthropic.com/en/docs/resources/model-deprecations for more information.
7967
7968 High-performance model for agents and coding
7969
7970 - `string`
7971
7972 - `effort: optional BetaManagedAgentsEffortLow or BetaManagedAgentsEffortMedium or BetaManagedAgentsEffortHigh or 2 more`
7973
7974 How hard Claude works on each inference call. One of `low`, `medium`, `high`, `xhigh`, `max`. Always present; resolved to the per-model default at save time when not supplied.
7975
7976 - `BetaManagedAgentsEffortLow object`
7977
7978 Low effort. Favors latency over reasoning depth.
7979
7980 - `type: "low"`
7981
7982 - `BetaManagedAgentsEffortMedium object`
7983
7984 Medium effort. Balances latency and reasoning depth.
7985
7986 - `type: "medium"`
7987
7988 - `BetaManagedAgentsEffortHigh object`
7989
7990 High effort. Favors reasoning depth.
7991
7992 - `type: "high"`
7993
7994 - `BetaManagedAgentsEffortXhigh object`
7995
7996 Extra-high effort. Not all models accept this level.
7997
7998 - `type: "xhigh"`
7999
8000 - `BetaManagedAgentsEffortMax object`
8001
8002 Maximum effort. Favors reasoning depth over latency.
8003
8004 - `type: "max"`
8005
8006 - `inference_geo: optional string`
8007
8008 Geographic region for model inference. When unset, requests fall through to the workspace's default_inference_geo.
8009
8010 - `speed: optional "standard" or "fast"`
8011
8012 Inference speed mode. `fast` provides significantly faster output token generation at premium pricing. Defaults to `standard`. Not all models support `fast`; invalid combinations are rejected at create time.
8013
8014 - `"standard"`
8015
8016 - `"fast"`
8017
8018 - `multiagent: BetaManagedAgentsSessionMultiagent or null`
8019
8020 Resolved multiagent orchestration configuration. Null when the agent is single-threaded.
8021
8022 - `BetaManagedAgentsSessionMultiagentCoordinator object`
8023
8024 Resolved coordinator topology with full agent definitions for each roster member.
8025
8026 - `type: "coordinator"`
8027
8028 - `agents: array of BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
8029
8030 Full `agent` definitions the coordinator may spawn as session threads.
8031
8032 - `BetaManagedAgentsSessionThreadAgent object`
8033
8034 Resolved `agent` definition for a single `session_thread`. Snapshot of the agent at thread creation time. The multiagent roster is not repeated here; read it from `Session.agent`.
8035
8036 - `type: "agent"`
8037
8038 - `id: string`
8039
8040 - `description: string or null`
8041
8042 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
8043
8044 - `type: "url"`
8045
8046 - `name: string`
8047
8048 - `url: string`
8049
8050 - `model: BetaManagedAgentsModelConfig`
8051
8052 Model identifier and configuration.
8053
8054 - `name: string`
8055
8056 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
8057
8058 - `BetaManagedAgentsAnthropicSkill object`
8059
8060 A resolved Anthropic-managed skill.
8061
8062 - `type: "anthropic"`
8063
8064 - `skill_id: string`
8065
8066 - `version: string`
8067
8068 - `BetaManagedAgentsCustomSkill object`
8069
8070 A resolved user-created custom skill.
8071
8072 - `type: "custom"`
8073
8074 - `skill_id: string`
8075
8076 - `version: string`
8077
8078 - `system: string or null`
8079
8080 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
8081
8082 - `BetaManagedAgentsAgentToolset20260401 object`
8083
8084 - `type: "agent_toolset_20260401"`
8085
8086 - `configs: array of BetaManagedAgentsAgentToolConfig`
8087
8088 - `BetaManagedAgentsBashToolConfig object`
8089
8090 Configuration for the bash tool.
8091
8092 - `type: "bash"`
8093
8094 - `enabled: boolean`
8095
8096 - `name: "bash"`
8097
8098 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
8099
8100 Permission policy for tool execution.
8101
8102 - `BetaManagedAgentsAlwaysAllowPolicy object`
8103
8104 Tool calls are automatically approved without user confirmation.
8105
8106 - `type: "always_allow"`
8107
8108 - `BetaManagedAgentsAlwaysAskPolicy object`
8109
8110 Tool calls require user confirmation before execution.
8111
8112 - `type: "always_ask"`
8113
8114 - `BetaManagedAgentsAutoPolicy object`
8115
8116 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
8117
8118 - `type: "auto"`
8119
8120 - `BetaManagedAgentsEditToolConfig object`
8121
8122 Configuration for the edit tool.
8123
8124 - `type: "edit"`
8125
8126 - `enabled: boolean`
8127
8128 - `name: "edit"`
8129
8130 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
8131
8132 Permission policy for tool execution.
8133
8134 - `BetaManagedAgentsAlwaysAllowPolicy object`
8135
8136 Tool calls are automatically approved without user confirmation.
8137
8138 - `BetaManagedAgentsAlwaysAskPolicy object`
8139
8140 Tool calls require user confirmation before execution.
8141
8142 - `BetaManagedAgentsAutoPolicy object`
8143
8144 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
8145
8146 - `BetaManagedAgentsReadToolConfig object`
8147
8148 Configuration for the read tool.
8149
8150 - `type: "read"`
8151
8152 - `enabled: boolean`
8153
8154 - `name: "read"`
8155
8156 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
8157
8158 Permission policy for tool execution.
8159
8160 - `BetaManagedAgentsAlwaysAllowPolicy object`
8161
8162 Tool calls are automatically approved without user confirmation.
8163
8164 - `BetaManagedAgentsAlwaysAskPolicy object`
8165
8166 Tool calls require user confirmation before execution.
8167
8168 - `BetaManagedAgentsAutoPolicy object`
8169
8170 The server decides each tool call individually: it judges, from the
8150 **Deprecated**: Will reach end-of-life on November 30, 2026. Please migrate to claude-sonnet-5-5. Visit https://docs.anthropic.com/en/docs/resourc
No line in this hunk matches that.