Update Session changedapi/beta/sessions/update
Nearest release: v2.1.239, published 2 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+577added
Lines−115removed
From line
129
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits23to this page, all time
The whole hunk
from line 129, old and new numbered
/
The two sides of this change are more than 400 edits apart, too far apart to line up, so this is the differ's own diff of it and the words inside a line are not marked.
from line 129
129129
130130 Per-tool configuration overrides.
131131
132 - `name: "bash" or "edit" or "read" or 5 more`
133
134 Built-in agent tool identifier.
135
136 - `"bash"`
137
138 - `"edit"`
139
140 - `"read"`
141
142 - `"write"`
143
144 - `"glob"`
145
146 - `"grep"`
147
148 - `"web_fetch"`
149
150 - `"web_search"`
132 - `BetaManagedAgentsBashToolConfigParams object { name, enabled, permission_policy, type }`
133
134 Configuration override for the bash tool.
135
136 - `name: "bash"`
137
138 Must be "bash".
139
140 - `"bash"`
141
142 - `enabled: optional boolean or null`
143
144 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
145
146 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
147
148 Permission policy for tool execution.
149
150 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
151
152 Tool calls are automatically approved without user confirmation.
153
154 - `type: "always_allow"`
155
156 - `"always_allow"`
157
158 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
159
160 Tool calls require user confirmation before execution.
161
162 - `type: "always_ask"`
163
164 - `"always_ask"`
165
166 - `type: optional "bash"`
167
168 - `"bash"`
169
170 - `BetaManagedAgentsEditToolConfigParams object { name, enabled, permission_policy, type }`
171
172 Configuration override for the edit tool.
173
174 - `name: "edit"`
175
176 Must be "edit".
177
178 - `"edit"`
179
180 - `enabled: optional boolean or null`
181
182 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
183
184 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
185
186 Permission policy for tool execution.
187
188 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
189
190 Tool calls are automatically approved without user confirmation.
191
192 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
193
194 Tool calls require user confirmation before execution.
195
196 - `type: optional "edit"`
197
198 - `"edit"`
199
200 - `BetaManagedAgentsReadToolConfigParams object { name, enabled, permission_policy, type }`
201
202 Configuration override for the read tool.
203
204 - `name: "read"`
205
206 Must be "read".
207
208 - `"read"`
209
210 - `enabled: optional boolean or null`
211
212 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
213
214 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
215
216 Permission policy for tool execution.
217
218 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
219
220 Tool calls are automatically approved without user confirmation.
221
222 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
223
224 Tool calls require user confirmation before execution.
225
226 - `type: optional "read"`
227
228 - `"read"`
229
230 - `BetaManagedAgentsWriteToolConfigParams object { name, enabled, permission_policy, type }`
231
232 Configuration override for the write tool.
233
234 - `name: "write"`
235
236 Must be "write".
237
238 - `"write"`
239
240 - `enabled: optional boolean or null`
241
242 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
243
244 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
245
246 Permission policy for tool execution.
247
248 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
249
250 Tool calls are automatically approved without user confirmation.
251
252 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
253
254 Tool calls require user confirmation before execution.
255
256 - `type: optional "write"`
257
258 - `"write"`
259
260 - `BetaManagedAgentsGlobToolConfigParams object { name, enabled, permission_policy, type }`
261
262 Configuration override for the glob tool.
263
264 - `name: "glob"`
265
266 Must be "glob".
267
268 - `"glob"`
269
270 - `enabled: optional boolean or null`
271
272 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
273
274 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
275
276 Permission policy for tool execution.
277
278 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
279
280 Tool calls are automatically approved without user confirmation.
281
282 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
283
284 Tool calls require user confirmation before execution.
285
286 - `type: optional "glob"`
287
288 - `"glob"`
289
290 - `BetaManagedAgentsGrepToolConfigParams object { name, enabled, permission_policy, type }`
291
292 Configuration override for the grep tool.
293
294 - `name: "grep"`
295
296 Must be "grep".
297
298 - `"grep"`
299
300 - `enabled: optional boolean or null`
301
302 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
303
304 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
305
306 Permission policy for tool execution.
307
308 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
309
310 Tool calls are automatically approved without user confirmation.
311
312 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
313
314 Tool calls require user confirmation before execution.
315
316 - `type: optional "grep"`
317
318 - `"grep"`
319
320 - `BetaManagedAgentsWebFetchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
321
322 Configuration override for the web_fetch tool.
323
324 - `name: "web_fetch"`
325
326 Must be "web_fetch".
327
328 - `"web_fetch"`
329
330 - `allowed_domains: optional array of string`
331
332 Only fetch URLs whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "docs.example.com" (no scheme, port, or path). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with blocked_domains.
333
334 - `blocked_domains: optional array of string`
335
336 Never fetch URLs whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "ads.example.com" (no scheme, port, or path). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with allowed_domains.
337
338 - `enabled: optional boolean or null`
339
340 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
341
342 - `max_content_tokens: optional number or null`
343
344 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.
345
346 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
347
348 Permission policy for tool execution.
349
350 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
351
352 Tool calls are automatically approved without user confirmation.
353
354 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
355
356 Tool calls require user confirmation before execution.
357
358 - `type: optional "web_fetch"`
359
360 - `"web_fetch"`
361
362 - `BetaManagedAgentsWebSearchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
363
364 Configuration override for the web_search tool.
365
366 - `name: "web_search"`
367
368 Must be "web_search".
369
370 - `"web_search"`
371
372 - `allowed_domains: optional array of string`
373
374 Only return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "docs.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with blocked_domains.
375
376 - `blocked_domains: optional array of string`
377
378 Never return search results whose host is one of these domains or a subdomain of one. Each entry is a plain hostname like "ads.example.com" (no scheme or port; an optional path suffix is accepted). At most 64 entries; an empty list is rejected (omit the field instead). Cannot be combined with allowed_domains.
379
380 - `enabled: optional boolean or null`
381
382 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
383
384 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
385
386 Permission policy for tool execution.
387
388 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
389
390 Tool calls are automatically approved without user confirmation.
391
392 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
393
394 Tool calls require user confirmation before execution.
395
396 - `type: optional "web_search"`
397
398 - `"web_search"`
399
400 - `user_location: optional BetaManagedAgentsUserLocation or null`
401
402 Approximate user location for search result localization.
403
404 - `type: "approximate"`
405
406 Location precision. Only "approximate" is supported.
407
408 - `"approximate"`
409
410 - `city: optional string or null`
411
412 City name.
413
414 - `country: optional string or null`
415
416 Two-letter ISO 3166-1 country code, uppercase.
417
418 - `region: optional string or null`
419
420 Region or state name.
421
422 - `timezone: optional string or null`
423
424 IANA timezone identifier, e.g. "America/Los_Angeles".
425
426 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`
427
428 Default configuration for all tools in a toolset.
151429
152430 - `enabled: optional boolean or null`
153431
154 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
432 Whether tools are enabled and available to Claude by default. Defaults to true if not specified.
155433
156434 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
157435
from line 439
161439
162440 Tool calls are automatically approved without user confirmation.
163441
164 - `type: "always_allow"`
165
166 - `"always_allow"`
167
168442 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
169443
170444 Tool calls require user confirmation before execution.
171445
172 - `type: "always_ask"`
173
174 - `"always_ask"`
175
176 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`
177
178 Default configuration for all tools in a toolset.
446 - `BetaManagedAgentsMCPToolsetParams object { mcp_server_name, type, configs, default_config }`
447
448 Configuration for tools from an MCP server defined in `mcp_servers`.
449
450 - `mcp_server_name: string`
451
452 Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.
453
454 - `type: "mcp_toolset"`
455
456 - `"mcp_toolset"`
457
458 - `configs: optional array of BetaManagedAgentsMCPToolConfigParams`
459
460 Per-tool configuration overrides.
461
462 - `name: string`
463
464 Name of the MCP tool to configure. 1-128 characters.
179465
180466 - `enabled: optional boolean or null`
181467
182 Whether tools are enabled and available to Claude by default. Defaults to true if not specified.
468 Whether this tool is enabled. Overrides the `default_config` setting.
183469
184470 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
185471
from line 479
193479
194480 Tool calls require user confirmation before execution.
195481
196 - `BetaManagedAgentsMCPToolsetParams object { mcp_server_name, type, configs, default_config }`
197
198 Configuration for tools from an MCP server defined in `mcp_servers`.
199
200 - `mcp_server_name: string`
201
202 Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.
203
204 - `type: "mcp_toolset"`
205
206 - `"mcp_toolset"`
207
208 - `configs: optional array of BetaManagedAgentsMCPToolConfigParams`
209
210 Per-tool configuration overrides.
211
212 - `name: string`
213
214 Name of the MCP tool to configure. 1-128 characters.
482 - `default_config: optional BetaManagedAgentsMCPToolsetDefaultConfigParams or null`
483
484 Default configuration for all tools from an MCP server.
215485
216486 - `enabled: optional boolean or null`
217487
218 Whether this tool is enabled. Overrides the `default_config` setting.
488 Whether tools are enabled by default. Defaults to true if not specified.
219489
220490 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
221491
from line 499
229499
230500 Tool calls require user confirmation before execution.
231501
232 - `default_config: optional BetaManagedAgentsMCPToolsetDefaultConfigParams or null`
233
234 Default configuration for all tools from an MCP server.
235
236 - `enabled: optional boolean or null`
237
238 Whether tools are enabled by default. Defaults to true if not specified.
239
240 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
241
242 Permission policy for tool execution.
243
244 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
245
246 Tool calls are automatically approved without user confirmation.
247
248 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
249
250 Tool calls require user confirmation before execution.
251
252502 - `BetaManagedAgentsCustomToolParams object { description, input_schema, name, type }`
253503
254504 A custom tool that is executed by the API client rather than the agent. When the agent calls this tool, an `agent.custom_tool_use` event is emitted and the session goes idle, waiting for the client to provide the result via a `user.custom_tool_result` event.
from line 777
527777
528778 - `configs: array of BetaManagedAgentsAgentToolConfig`
529779
530 - `enabled: boolean`
531
532 - `name: "bash" or "edit" or "read" or 5 more`
533
534 Built-in agent tool identifier.
535
536 - `"bash"`
537
538 - `"edit"`
539
540 - `"read"`
541
542 - `"write"`
543
544 - `"glob"`
545
546 - `"grep"`
547
548 - `"web_fetch"`
549
550 - `"web_search"`
551
552 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
553
554 Permission policy for tool execution.
555
556 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
557
558 Tool calls are automatically approved without user confirmation.
559
560 - `type: "always_allow"`
561
562 - `"always_allow"`
563
564 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
565
566 Tool calls require user confirmation before execution.
567
568 - `type: "always_ask"`
569
570 - `"always_ask"`
780 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
781
782 Configuration for the bash tool.
783
784 - `enabled: boolean`
785
786 - `name: "bash"`
787
788 - `"bash"`
789
790 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
791
792 Permission policy for tool execution.
793
794 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
795
796 Tool calls are automatically approved without user confirmation.
797
798 - `type: "always_allow"`
799
800 - `"always_allow"`
801
802 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
803
804 Tool calls require user confirmation before execution.
805
806 - `type: "always_ask"`
807
808 - `"always_ask"`
809
810 - `type: "bash"`
811
812 - `"bash"`
813
814 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
815
816 Configuration for the edit tool.
817
818 - `enabled: boolean`
819
820 - `name: "edit"`
821
822 - `"edit"`
823
824 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
825
826 Permission policy for tool execution.
827
828 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
829
830 Tool calls are automatically approved without user confirmation.
831
832 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
833
834 Tool calls require user confirmation before execution.
835
836 - `type: "edit"`
837
838 - `"edit"`
839
840 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
841
842 Configuration for the read tool.
843
844 - `enabled: boolean`
845
846 - `name: "read"`
847
848 - `"read"`
849
850 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
851
852 Permission policy for tool execution.
853
854 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
855
856 Tool calls are automatically approved without user confirmation.
857
858 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
859
860 Tool calls require user confirmation before execution.
861
862 - `type: "read"`
863
864 - `"read"`
865
866 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
867
868 Configuration for the write tool.
869
870 - `enabled: boolean`
871
872 - `name: "write"`
873
874 - `"write"`
875
876 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
877
878 Permission policy for tool execution.
879
880 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
881
882 Tool calls are automatically approved without user confirmation.
883
884 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
885
886 Tool calls require user confirmation before execution.
887
888 - `type: "write"`
889
890 - `"write"`
891
892 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
893
894 Configuration for the glob tool.
895
896 - `enabled: boolean`
897
898 - `name: "glob"`
899
900 - `"glob"`
901
902 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
903
904 Permission policy for tool execution.
905
906 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
907
908 Tool calls are automatically approved without user confirmation.
909
910 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
911
912 Tool calls require user confirmation before execution.
913
914 - `type: "glob"`
915
916 - `"glob"`
917
918 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
919
920 Configuration for the grep tool.
921
922 - `enabled: boolean`
923
924 - `name: "grep"`
925
926 - `"grep"`
927
928 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
929
930 Permission policy for tool execution.
931
932 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
933
934 Tool calls are automatically approved without user confirmation.
935
936 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
937
938 Tool calls require user confirmation before execution.
939
940 - `type: "grep"`
941
942 - `"grep"`
943
944 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
945
946 Configuration for the web_fetch tool.
947
948 - `enabled: boolean`
949
950 - `name: "web_fetch"`
951
952 - `"web_fetch"`
953
954 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
955
956 Permission policy for tool execution.
957
958 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
959
960 Tool calls are automatically approved without user confirmation.
961
962 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
963
964 Tool calls require user confirmation before execution.
965
966 - `type: "web_fetch"`
967
968 - `"web_fetch"`
969
970 - `allowed_domains: optional array of string`
971
972 - `blocked_domains: optional array of string`
973
974 - `max_content_tokens: optional number or null`
975
976 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
977
978 Configuration for the web_search tool.
979
980 - `enabled: boolean`
981
982 - `name: "web_search"`
983
984 - `"web_search"`
985
986 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
987
988 Permission policy for tool execution.
989
990 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
991
992 Tool calls are automatically approved without user confirmation.
993
994 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
995
996 Tool calls require user confirmation before execution.
997
998 - `type: "web_search"`
999
1000 - `"web_search"`
1001
1002 - `allowed_domains: optional array of string`
1003
1004 - `blocked_domains: optional array of string`
1005
1006 - `user_location: optional BetaManagedAgentsUserLocation or null`
1007
1008 Approximate user location for search result localization.
1009
1010 - `type: "approximate"`
1011
1012 Location precision. Only "approximate" is supported.
1013
1014 - `"approximate"`
1015
1016 - `city: optional string or null`
1017
1018 City name.
1019
1020 - `country: optional string or null`
1021
1022 Two-letter ISO 3166-1 country code, uppercase.
1023
1024 - `region: optional string or null`
1025
1026 Region or state name.
1027
1028 - `timezone: optional string or null`
1029
1030 IANA timezone identifier, e.g. "America/Los_Angeles".
5711031
5721032 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
5731033
from line 1500
10401500 "name": "bash",
10411501 "permission_policy": {
10421502 "type": "always_allow"
1043 }
1503 },
1504 "type": "bash"
10441505 }
10451506 ],
10461507 "default_config": {
from line 1541
10801541 "name": "bash",
10811542 "permission_policy": {
10821543 "type": "always_allow"
1083 }
1544 },
1545 "type": "bash"
10841546 }
10851547 ],
10861548 "default_config": {
10871549
No line in this hunk matches that.