Update Agent changedapi/beta/agents/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+575added
Lines−114removed
From line
377
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits25to this page, all time
The whole hunk
from line 377, 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 377
377377
378378 Per-tool configuration overrides.
379379
380 - `name: "bash" or "edit" or "read" or 5 more`
381
382 Built-in agent tool identifier.
383
384 - `"bash"`
385
386 - `"edit"`
387
388 - `"read"`
389
390 - `"write"`
391
392 - `"glob"`
393
394 - `"grep"`
395
396 - `"web_fetch"`
397
398 - `"web_search"`
380 - `BetaManagedAgentsBashToolConfigParams object { name, enabled, permission_policy, type }`
381
382 Configuration override for the bash tool.
383
384 - `name: "bash"`
385
386 Must be "bash".
387
388 - `"bash"`
389
390 - `enabled: optional boolean or null`
391
392 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
393
394 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
395
396 Permission policy for tool execution.
397
398 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
399
400 Tool calls are automatically approved without user confirmation.
401
402 - `type: "always_allow"`
403
404 - `"always_allow"`
405
406 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
407
408 Tool calls require user confirmation before execution.
409
410 - `type: "always_ask"`
411
412 - `"always_ask"`
413
414 - `type: optional "bash"`
415
416 - `"bash"`
417
418 - `BetaManagedAgentsEditToolConfigParams object { name, enabled, permission_policy, type }`
419
420 Configuration override for the edit tool.
421
422 - `name: "edit"`
423
424 Must be "edit".
425
426 - `"edit"`
427
428 - `enabled: optional boolean or null`
429
430 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
431
432 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
433
434 Permission policy for tool execution.
435
436 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
437
438 Tool calls are automatically approved without user confirmation.
439
440 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
441
442 Tool calls require user confirmation before execution.
443
444 - `type: optional "edit"`
445
446 - `"edit"`
447
448 - `BetaManagedAgentsReadToolConfigParams object { name, enabled, permission_policy, type }`
449
450 Configuration override for the read tool.
451
452 - `name: "read"`
453
454 Must be "read".
455
456 - `"read"`
457
458 - `enabled: optional boolean or null`
459
460 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
461
462 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
463
464 Permission policy for tool execution.
465
466 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
467
468 Tool calls are automatically approved without user confirmation.
469
470 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
471
472 Tool calls require user confirmation before execution.
473
474 - `type: optional "read"`
475
476 - `"read"`
477
478 - `BetaManagedAgentsWriteToolConfigParams object { name, enabled, permission_policy, type }`
479
480 Configuration override for the write tool.
481
482 - `name: "write"`
483
484 Must be "write".
485
486 - `"write"`
487
488 - `enabled: optional boolean or null`
489
490 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
491
492 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
493
494 Permission policy for tool execution.
495
496 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
497
498 Tool calls are automatically approved without user confirmation.
499
500 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
501
502 Tool calls require user confirmation before execution.
503
504 - `type: optional "write"`
505
506 - `"write"`
507
508 - `BetaManagedAgentsGlobToolConfigParams object { name, enabled, permission_policy, type }`
509
510 Configuration override for the glob tool.
511
512 - `name: "glob"`
513
514 Must be "glob".
515
516 - `"glob"`
517
518 - `enabled: optional boolean or null`
519
520 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
521
522 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
523
524 Permission policy for tool execution.
525
526 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
527
528 Tool calls are automatically approved without user confirmation.
529
530 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
531
532 Tool calls require user confirmation before execution.
533
534 - `type: optional "glob"`
535
536 - `"glob"`
537
538 - `BetaManagedAgentsGrepToolConfigParams object { name, enabled, permission_policy, type }`
539
540 Configuration override for the grep tool.
541
542 - `name: "grep"`
543
544 Must be "grep".
545
546 - `"grep"`
547
548 - `enabled: optional boolean or null`
549
550 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
551
552 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
553
554 Permission policy for tool execution.
555
556 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
557
558 Tool calls are automatically approved without user confirmation.
559
560 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
561
562 Tool calls require user confirmation before execution.
563
564 - `type: optional "grep"`
565
566 - `"grep"`
567
568 - `BetaManagedAgentsWebFetchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
569
570 Configuration override for the web_fetch tool.
571
572 - `name: "web_fetch"`
573
574 Must be "web_fetch".
575
576 - `"web_fetch"`
577
578 - `allowed_domains: optional array of string`
579
580 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.
581
582 - `blocked_domains: optional array of string`
583
584 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.
585
586 - `enabled: optional boolean or null`
587
588 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
589
590 - `max_content_tokens: optional number or null`
591
592 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.
593
594 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
595
596 Permission policy for tool execution.
597
598 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
599
600 Tool calls are automatically approved without user confirmation.
601
602 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
603
604 Tool calls require user confirmation before execution.
605
606 - `type: optional "web_fetch"`
607
608 - `"web_fetch"`
609
610 - `BetaManagedAgentsWebSearchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
611
612 Configuration override for the web_search tool.
613
614 - `name: "web_search"`
615
616 Must be "web_search".
617
618 - `"web_search"`
619
620 - `allowed_domains: optional array of string`
621
622 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.
623
624 - `blocked_domains: optional array of string`
625
626 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.
627
628 - `enabled: optional boolean or null`
629
630 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
631
632 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
633
634 Permission policy for tool execution.
635
636 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
637
638 Tool calls are automatically approved without user confirmation.
639
640 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
641
642 Tool calls require user confirmation before execution.
643
644 - `type: optional "web_search"`
645
646 - `"web_search"`
647
648 - `user_location: optional BetaManagedAgentsUserLocation or null`
649
650 Approximate user location for search result localization.
651
652 - `type: "approximate"`
653
654 Location precision. Only "approximate" is supported.
655
656 - `"approximate"`
657
658 - `city: optional string or null`
659
660 City name.
661
662 - `country: optional string or null`
663
664 Two-letter ISO 3166-1 country code, uppercase.
665
666 - `region: optional string or null`
667
668 Region or state name.
669
670 - `timezone: optional string or null`
671
672 IANA timezone identifier, e.g. "America/Los_Angeles".
673
674 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`
675
676 Default configuration for all tools in a toolset.
399677
400678 - `enabled: optional boolean or null`
401679
402 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
680 Whether tools are enabled and available to Claude by default. Defaults to true if not specified.
403681
404682 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
405683
from line 687
409687
410688 Tool calls are automatically approved without user confirmation.
411689
412 - `type: "always_allow"`
413
414 - `"always_allow"`
415
416690 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
417691
418692 Tool calls require user confirmation before execution.
419693
420 - `type: "always_ask"`
421
422 - `"always_ask"`
423
424 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`
425
426 Default configuration for all tools in a toolset.
694 - `BetaManagedAgentsMCPToolsetParams object { mcp_server_name, type, configs, default_config }`
695
696 Configuration for tools from an MCP server defined in `mcp_servers`.
697
698 - `mcp_server_name: string`
699
700 Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.
701
702 - `type: "mcp_toolset"`
703
704 - `"mcp_toolset"`
705
706 - `configs: optional array of BetaManagedAgentsMCPToolConfigParams`
707
708 Per-tool configuration overrides.
709
710 - `name: string`
711
712 Name of the MCP tool to configure. 1-128 characters.
427713
428714 - `enabled: optional boolean or null`
429715
430 Whether tools are enabled and available to Claude by default. Defaults to true if not specified.
716 Whether this tool is enabled. Overrides the `default_config` setting.
431717
432718 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
433719
from line 727
441727
442728 Tool calls require user confirmation before execution.
443729
444 - `BetaManagedAgentsMCPToolsetParams object { mcp_server_name, type, configs, default_config }`
445
446 Configuration for tools from an MCP server defined in `mcp_servers`.
447
448 - `mcp_server_name: string`
449
450 Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.
451
452 - `type: "mcp_toolset"`
453
454 - `"mcp_toolset"`
455
456 - `configs: optional array of BetaManagedAgentsMCPToolConfigParams`
457
458 Per-tool configuration overrides.
459
460 - `name: string`
461
462 Name of the MCP tool to configure. 1-128 characters.
730 - `default_config: optional BetaManagedAgentsMCPToolsetDefaultConfigParams or null`
731
732 Default configuration for all tools from an MCP server.
463733
464734 - `enabled: optional boolean or null`
465735
466 Whether this tool is enabled. Overrides the `default_config` setting.
736 Whether tools are enabled by default. Defaults to true if not specified.
467737
468738 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
469739
from line 747
477747
478748 Tool calls require user confirmation before execution.
479749
480 - `default_config: optional BetaManagedAgentsMCPToolsetDefaultConfigParams or null`
481
482 Default configuration for all tools from an MCP server.
483
484 - `enabled: optional boolean or null`
485
486 Whether tools are enabled by default. Defaults to true if not specified.
487
488 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
489
490 Permission policy for tool execution.
491
492 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
493
494 Tool calls are automatically approved without user confirmation.
495
496 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
497
498 Tool calls require user confirmation before execution.
499
500750 - `BetaManagedAgentsCustomToolParams object { description, input_schema, name, type }`
501751
502752 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 1007
7571007
7581008 - `configs: array of BetaManagedAgentsAgentToolConfig`
7591009
760 - `enabled: boolean`
761
762 - `name: "bash" or "edit" or "read" or 5 more`
763
764 Built-in agent tool identifier.
765
766 - `"bash"`
767
768 - `"edit"`
769
770 - `"read"`
771
772 - `"write"`
773
774 - `"glob"`
775
776 - `"grep"`
777
778 - `"web_fetch"`
779
780 - `"web_search"`
781
782 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
783
784 Permission policy for tool execution.
785
786 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
787
788 Tool calls are automatically approved without user confirmation.
789
790 - `type: "always_allow"`
791
792 - `"always_allow"`
793
794 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
795
796 Tool calls require user confirmation before execution.
797
798 - `type: "always_ask"`
799
800 - `"always_ask"`
1010 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
1011
1012 Configuration for the bash tool.
1013
1014 - `enabled: boolean`
1015
1016 - `name: "bash"`
1017
1018 - `"bash"`
1019
1020 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1021
1022 Permission policy for tool execution.
1023
1024 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1025
1026 Tool calls are automatically approved without user confirmation.
1027
1028 - `type: "always_allow"`
1029
1030 - `"always_allow"`
1031
1032 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1033
1034 Tool calls require user confirmation before execution.
1035
1036 - `type: "always_ask"`
1037
1038 - `"always_ask"`
1039
1040 - `type: "bash"`
1041
1042 - `"bash"`
1043
1044 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
1045
1046 Configuration for the edit tool.
1047
1048 - `enabled: boolean`
1049
1050 - `name: "edit"`
1051
1052 - `"edit"`
1053
1054 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1055
1056 Permission policy for tool execution.
1057
1058 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1059
1060 Tool calls are automatically approved without user confirmation.
1061
1062 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1063
1064 Tool calls require user confirmation before execution.
1065
1066 - `type: "edit"`
1067
1068 - `"edit"`
1069
1070 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
1071
1072 Configuration for the read tool.
1073
1074 - `enabled: boolean`
1075
1076 - `name: "read"`
1077
1078 - `"read"`
1079
1080 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1081
1082 Permission policy for tool execution.
1083
1084 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1085
1086 Tool calls are automatically approved without user confirmation.
1087
1088 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1089
1090 Tool calls require user confirmation before execution.
1091
1092 - `type: "read"`
1093
1094 - `"read"`
1095
1096 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
1097
1098 Configuration for the write tool.
1099
1100 - `enabled: boolean`
1101
1102 - `name: "write"`
1103
1104 - `"write"`
1105
1106 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1107
1108 Permission policy for tool execution.
1109
1110 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1111
1112 Tool calls are automatically approved without user confirmation.
1113
1114 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1115
1116 Tool calls require user confirmation before execution.
1117
1118 - `type: "write"`
1119
1120 - `"write"`
1121
1122 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
1123
1124 Configuration for the glob tool.
1125
1126 - `enabled: boolean`
1127
1128 - `name: "glob"`
1129
1130 - `"glob"`
1131
1132 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1133
1134 Permission policy for tool execution.
1135
1136 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1137
1138 Tool calls are automatically approved without user confirmation.
1139
1140 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1141
1142 Tool calls require user confirmation before execution.
1143
1144 - `type: "glob"`
1145
1146 - `"glob"`
1147
1148 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
1149
1150 Configuration for the grep tool.
1151
1152 - `enabled: boolean`
1153
1154 - `name: "grep"`
1155
1156 - `"grep"`
1157
1158 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1159
1160 Permission policy for tool execution.
1161
1162 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1163
1164 Tool calls are automatically approved without user confirmation.
1165
1166 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1167
1168 Tool calls require user confirmation before execution.
1169
1170 - `type: "grep"`
1171
1172 - `"grep"`
1173
1174 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
1175
1176 Configuration for the web_fetch tool.
1177
1178 - `enabled: boolean`
1179
1180 - `name: "web_fetch"`
1181
1182 - `"web_fetch"`
1183
1184 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1185
1186 Permission policy for tool execution.
1187
1188 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1189
1190 Tool calls are automatically approved without user confirmation.
1191
1192 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1193
1194 Tool calls require user confirmation before execution.
1195
1196 - `type: "web_fetch"`
1197
1198 - `"web_fetch"`
1199
1200 - `allowed_domains: optional array of string`
1201
1202 - `blocked_domains: optional array of string`
1203
1204 - `max_content_tokens: optional number or null`
1205
1206 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
1207
1208 Configuration for the web_search tool.
1209
1210 - `enabled: boolean`
1211
1212 - `name: "web_search"`
1213
1214 - `"web_search"`
1215
1216 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1217
1218 Permission policy for tool execution.
1219
1220 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1221
1222 Tool calls are automatically approved without user confirmation.
1223
1224 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1225
1226 Tool calls require user confirmation before execution.
1227
1228 - `type: "web_search"`
1229
1230 - `"web_search"`
1231
1232 - `allowed_domains: optional array of string`
1233
1234 - `blocked_domains: optional array of string`
1235
1236 - `user_location: optional BetaManagedAgentsUserLocation or null`
1237
1238 Approximate user location for search result localization.
1239
1240 - `type: "approximate"`
1241
1242 Location precision. Only "approximate" is supported.
1243
1244 - `"approximate"`
1245
1246 - `city: optional string or null`
1247
1248 City name.
1249
1250 - `country: optional string or null`
1251
1252 Two-letter ISO 3166-1 country code, uppercase.
1253
1254 - `region: optional string or null`
1255
1256 Region or state name.
1257
1258 - `timezone: optional string or null`
1259
1260 IANA timezone identifier, e.g. "America/Los_Angeles".
8011261
8021262 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
8031263
from line 1434
9741434 "name": "bash",
9751435 "permission_policy": {
9761436 "type": "always_allow"
977 }
1437 },
1438 "type": "bash"
9781439 }
9791440 ],
9801441 "default_config": {
9811442
No line in this hunk matches that.