Agents changedapi/beta/agents
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+4,525added
Lines−701removed
From line
375
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits25to this page, all time
### Beta Managed Agents Bash Tool Config ### Beta Managed Agents Bash Tool Config Params ### Beta Managed Agents Edit Tool Config ### Beta Managed Agents Edit Tool Config Params ### Beta Managed Agents Glob Tool Config ### Beta Managed Agents Glob Tool Config Params ### Beta Managed Agents Grep Tool Config ### Beta Managed Agents Grep Tool Config Params ### Beta Managed Agents Read Tool Config ### Beta Managed Agents Read Tool Config Params ### Beta Managed Agents User Location ### Beta Managed Agents Web Fetch Tool Config ### Beta Managed Agents Web Fetch Tool Config Params ### Beta Managed Agents Web Search Tool Config ### Beta Managed Agents Web Search Tool Config Params ### Beta Managed Agents Write Tool Config ### Beta Managed Agents Write Tool Config Params
The whole hunk
from line 375, 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.
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 375
375375
376376 Per-tool configuration overrides.
377377
378 - `name: "bash" or "edit" or "read" or 5 more`
379
380 Built-in agent tool identifier.
381
382 - `"bash"`
383
384 - `"edit"`
385
386 - `"read"`
387
388 - `"write"`
389
390 - `"glob"`
391
392 - `"grep"`
393
394 - `"web_fetch"`
395
396 - `"web_search"`
378 - `BetaManagedAgentsBashToolConfigParams object { name, enabled, permission_policy, type }`
379
380 Configuration override for the bash tool.
381
382 - `name: "bash"`
383
384 Must be "bash".
385
386 - `"bash"`
387
388 - `enabled: optional boolean or null`
389
390 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
391
392 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
393
394 Permission policy for tool execution.
395
396 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
397
398 Tool calls are automatically approved without user confirmation.
399
400 - `type: "always_allow"`
401
402 - `"always_allow"`
403
404 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
405
406 Tool calls require user confirmation before execution.
407
408 - `type: "always_ask"`
409
410 - `"always_ask"`
411
412 - `type: optional "bash"`
413
414 - `"bash"`
415
416 - `BetaManagedAgentsEditToolConfigParams object { name, enabled, permission_policy, type }`
417
418 Configuration override for the edit tool.
419
420 - `name: "edit"`
421
422 Must be "edit".
423
424 - `"edit"`
425
426 - `enabled: optional boolean or null`
427
428 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
429
430 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
431
432 Permission policy for tool execution.
433
434 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
435
436 Tool calls are automatically approved without user confirmation.
437
438 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
439
440 Tool calls require user confirmation before execution.
441
442 - `type: optional "edit"`
443
444 - `"edit"`
445
446 - `BetaManagedAgentsReadToolConfigParams object { name, enabled, permission_policy, type }`
447
448 Configuration override for the read tool.
449
450 - `name: "read"`
451
452 Must be "read".
453
454 - `"read"`
455
456 - `enabled: optional boolean or null`
457
458 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
459
460 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
461
462 Permission policy for tool execution.
463
464 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
465
466 Tool calls are automatically approved without user confirmation.
467
468 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
469
470 Tool calls require user confirmation before execution.
471
472 - `type: optional "read"`
473
474 - `"read"`
475
476 - `BetaManagedAgentsWriteToolConfigParams object { name, enabled, permission_policy, type }`
477
478 Configuration override for the write tool.
479
480 - `name: "write"`
481
482 Must be "write".
483
484 - `"write"`
485
486 - `enabled: optional boolean or null`
487
488 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
489
490 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
491
492 Permission policy for tool execution.
493
494 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
495
496 Tool calls are automatically approved without user confirmation.
497
498 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
499
500 Tool calls require user confirmation before execution.
501
502 - `type: optional "write"`
503
504 - `"write"`
505
506 - `BetaManagedAgentsGlobToolConfigParams object { name, enabled, permission_policy, type }`
507
508 Configuration override for the glob tool.
509
510 - `name: "glob"`
511
512 Must be "glob".
513
514 - `"glob"`
515
516 - `enabled: optional boolean or null`
517
518 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
519
520 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
521
522 Permission policy for tool execution.
523
524 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
525
526 Tool calls are automatically approved without user confirmation.
527
528 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
529
530 Tool calls require user confirmation before execution.
531
532 - `type: optional "glob"`
533
534 - `"glob"`
535
536 - `BetaManagedAgentsGrepToolConfigParams object { name, enabled, permission_policy, type }`
537
538 Configuration override for the grep tool.
539
540 - `name: "grep"`
541
542 Must be "grep".
543
544 - `"grep"`
545
546 - `enabled: optional boolean or null`
547
548 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
549
550 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
551
552 Permission policy for tool execution.
553
554 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
555
556 Tool calls are automatically approved without user confirmation.
557
558 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
559
560 Tool calls require user confirmation before execution.
561
562 - `type: optional "grep"`
563
564 - `"grep"`
565
566 - `BetaManagedAgentsWebFetchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
567
568 Configuration override for the web_fetch tool.
569
570 - `name: "web_fetch"`
571
572 Must be "web_fetch".
573
574 - `"web_fetch"`
575
576 - `allowed_domains: optional array of string`
577
578 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.
579
580 - `blocked_domains: optional array of string`
581
582 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.
583
584 - `enabled: optional boolean or null`
585
586 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
587
588 - `max_content_tokens: optional number or null`
589
590 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.
591
592 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
593
594 Permission policy for tool execution.
595
596 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
597
598 Tool calls are automatically approved without user confirmation.
599
600 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
601
602 Tool calls require user confirmation before execution.
603
604 - `type: optional "web_fetch"`
605
606 - `"web_fetch"`
607
608 - `BetaManagedAgentsWebSearchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
609
610 Configuration override for the web_search tool.
611
612 - `name: "web_search"`
613
614 Must be "web_search".
615
616 - `"web_search"`
617
618 - `allowed_domains: optional array of string`
619
620 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.
621
622 - `blocked_domains: optional array of string`
623
624 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.
625
626 - `enabled: optional boolean or null`
627
628 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
629
630 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
631
632 Permission policy for tool execution.
633
634 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
635
636 Tool calls are automatically approved without user confirmation.
637
638 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
639
640 Tool calls require user confirmation before execution.
641
642 - `type: optional "web_search"`
643
644 - `"web_search"`
645
646 - `user_location: optional BetaManagedAgentsUserLocation or null`
647
648 Approximate user location for search result localization.
649
650 - `type: "approximate"`
651
652 Location precision. Only "approximate" is supported.
653
654 - `"approximate"`
655
656 - `city: optional string or null`
657
658 City name.
659
660 - `country: optional string or null`
661
662 Two-letter ISO 3166-1 country code, uppercase.
663
664 - `region: optional string or null`
665
666 Region or state name.
667
668 - `timezone: optional string or null`
669
670 IANA timezone identifier, e.g. "America/Los_Angeles".
671
672 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`
673
674 Default configuration for all tools in a toolset.
397675
398676 - `enabled: optional boolean or null`
399677
400 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
678 Whether tools are enabled and available to Claude by default. Defaults to true if not specified.
401679
402680 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
403681
from line 685
407685
408686 Tool calls are automatically approved without user confirmation.
409687
410 - `type: "always_allow"`
411
412 - `"always_allow"`
413
414688 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
415689
416690 Tool calls require user confirmation before execution.
417691
418 - `type: "always_ask"`
419
420 - `"always_ask"`
421
422 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`
423
424 Default configuration for all tools in a toolset.
692 - `BetaManagedAgentsMCPToolsetParams object { mcp_server_name, type, configs, default_config }`
693
694 Configuration for tools from an MCP server defined in `mcp_servers`.
695
696 - `mcp_server_name: string`
697
698 Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.
699
700 - `type: "mcp_toolset"`
701
702 - `"mcp_toolset"`
703
704 - `configs: optional array of BetaManagedAgentsMCPToolConfigParams`
705
706 Per-tool configuration overrides.
707
708 - `name: string`
709
710 Name of the MCP tool to configure. 1-128 characters.
425711
426712 - `enabled: optional boolean or null`
427713
428 Whether tools are enabled and available to Claude by default. Defaults to true if not specified.
714 Whether this tool is enabled. Overrides the `default_config` setting.
429715
430716 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
431717
from line 725
439725
440726 Tool calls require user confirmation before execution.
441727
442 - `BetaManagedAgentsMCPToolsetParams object { mcp_server_name, type, configs, default_config }`
443
444 Configuration for tools from an MCP server defined in `mcp_servers`.
445
446 - `mcp_server_name: string`
447
448 Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.
449
450 - `type: "mcp_toolset"`
451
452 - `"mcp_toolset"`
453
454 - `configs: optional array of BetaManagedAgentsMCPToolConfigParams`
455
456 Per-tool configuration overrides.
457
458 - `name: string`
459
460 Name of the MCP tool to configure. 1-128 characters.
728 - `default_config: optional BetaManagedAgentsMCPToolsetDefaultConfigParams or null`
729
730 Default configuration for all tools from an MCP server.
461731
462732 - `enabled: optional boolean or null`
463733
464 Whether this tool is enabled. Overrides the `default_config` setting.
734 Whether tools are enabled by default. Defaults to true if not specified.
465735
466736 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
467737
from line 745
475745
476746 Tool calls require user confirmation before execution.
477747
478 - `default_config: optional BetaManagedAgentsMCPToolsetDefaultConfigParams or null`
479
480 Default configuration for all tools from an MCP server.
481
482 - `enabled: optional boolean or null`
483
484 Whether tools are enabled by default. Defaults to true if not specified.
485
486 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
487
488 Permission policy for tool execution.
489
490 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
491
492 Tool calls are automatically approved without user confirmation.
493
494 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
495
496 Tool calls require user confirmation before execution.
497
498748 - `BetaManagedAgentsCustomToolParams object { description, input_schema, name, type }`
499749
500750 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 1001
7511001
7521002 - `configs: array of BetaManagedAgentsAgentToolConfig`
7531003
754 - `enabled: boolean`
755
756 - `name: "bash" or "edit" or "read" or 5 more`
757
758 Built-in agent tool identifier.
759
760 - `"bash"`
761
762 - `"edit"`
763
764 - `"read"`
765
766 - `"write"`
767
768 - `"glob"`
769
770 - `"grep"`
771
772 - `"web_fetch"`
773
774 - `"web_search"`
775
776 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
777
778 Permission policy for tool execution.
779
780 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
781
782 Tool calls are automatically approved without user confirmation.
783
784 - `type: "always_allow"`
785
786 - `"always_allow"`
787
788 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
789
790 Tool calls require user confirmation before execution.
791
792 - `type: "always_ask"`
793
794 - `"always_ask"`
1004 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
1005
1006 Configuration for the bash tool.
1007
1008 - `enabled: boolean`
1009
1010 - `name: "bash"`
1011
1012 - `"bash"`
1013
1014 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1015
1016 Permission policy for tool execution.
1017
1018 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1019
1020 Tool calls are automatically approved without user confirmation.
1021
1022 - `type: "always_allow"`
1023
1024 - `"always_allow"`
1025
1026 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1027
1028 Tool calls require user confirmation before execution.
1029
1030 - `type: "always_ask"`
1031
1032 - `"always_ask"`
1033
1034 - `type: "bash"`
1035
1036 - `"bash"`
1037
1038 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
1039
1040 Configuration for the edit tool.
1041
1042 - `enabled: boolean`
1043
1044 - `name: "edit"`
1045
1046 - `"edit"`
1047
1048 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1049
1050 Permission policy for tool execution.
1051
1052 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1053
1054 Tool calls are automatically approved without user confirmation.
1055
1056 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1057
1058 Tool calls require user confirmation before execution.
1059
1060 - `type: "edit"`
1061
1062 - `"edit"`
1063
1064 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
1065
1066 Configuration for the read tool.
1067
1068 - `enabled: boolean`
1069
1070 - `name: "read"`
1071
1072 - `"read"`
1073
1074 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1075
1076 Permission policy for tool execution.
1077
1078 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1079
1080 Tool calls are automatically approved without user confirmation.
1081
1082 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1083
1084 Tool calls require user confirmation before execution.
1085
1086 - `type: "read"`
1087
1088 - `"read"`
1089
1090 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
1091
1092 Configuration for the write tool.
1093
1094 - `enabled: boolean`
1095
1096 - `name: "write"`
1097
1098 - `"write"`
1099
1100 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1101
1102 Permission policy for tool execution.
1103
1104 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1105
1106 Tool calls are automatically approved without user confirmation.
1107
1108 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1109
1110 Tool calls require user confirmation before execution.
1111
1112 - `type: "write"`
1113
1114 - `"write"`
1115
1116 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
1117
1118 Configuration for the glob tool.
1119
1120 - `enabled: boolean`
1121
1122 - `name: "glob"`
1123
1124 - `"glob"`
1125
1126 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1127
1128 Permission policy for tool execution.
1129
1130 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1131
1132 Tool calls are automatically approved without user confirmation.
1133
1134 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1135
1136 Tool calls require user confirmation before execution.
1137
1138 - `type: "glob"`
1139
1140 - `"glob"`
1141
1142 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
1143
1144 Configuration for the grep tool.
1145
1146 - `enabled: boolean`
1147
1148 - `name: "grep"`
1149
1150 - `"grep"`
1151
1152 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1153
1154 Permission policy for tool execution.
1155
1156 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1157
1158 Tool calls are automatically approved without user confirmation.
1159
1160 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1161
1162 Tool calls require user confirmation before execution.
1163
1164 - `type: "grep"`
1165
1166 - `"grep"`
1167
1168 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
1169
1170 Configuration for the web_fetch tool.
1171
1172 - `enabled: boolean`
1173
1174 - `name: "web_fetch"`
1175
1176 - `"web_fetch"`
1177
1178 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1179
1180 Permission policy for tool execution.
1181
1182 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1183
1184 Tool calls are automatically approved without user confirmation.
1185
1186 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1187
1188 Tool calls require user confirmation before execution.
1189
1190 - `type: "web_fetch"`
1191
1192 - `"web_fetch"`
1193
1194 - `allowed_domains: optional array of string`
1195
1196 - `blocked_domains: optional array of string`
1197
1198 - `max_content_tokens: optional number or null`
1199
1200 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
1201
1202 Configuration for the web_search tool.
1203
1204 - `enabled: boolean`
1205
1206 - `name: "web_search"`
1207
1208 - `"web_search"`
1209
1210 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1211
1212 Permission policy for tool execution.
1213
1214 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1215
1216 Tool calls are automatically approved without user confirmation.
1217
1218 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1219
1220 Tool calls require user confirmation before execution.
1221
1222 - `type: "web_search"`
1223
1224 - `"web_search"`
1225
1226 - `allowed_domains: optional array of string`
1227
1228 - `blocked_domains: optional array of string`
1229
1230 - `user_location: optional BetaManagedAgentsUserLocation or null`
1231
1232 Approximate user location for search result localization.
1233
1234 - `type: "approximate"`
1235
1236 Location precision. Only "approximate" is supported.
1237
1238 - `"approximate"`
1239
1240 - `city: optional string or null`
1241
1242 City name.
1243
1244 - `country: optional string or null`
1245
1246 Two-letter ISO 3166-1 country code, uppercase.
1247
1248 - `region: optional string or null`
1249
1250 Region or state name.
1251
1252 - `timezone: optional string or null`
1253
1254 IANA timezone identifier, e.g. "America/Los_Angeles".
7951255
7961256 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
7971257
from line 1437
9771437 "name": "bash",
9781438 "permission_policy": {
9791439 "type": "always_allow"
980 }
1440 },
1441 "type": "bash"
9811442 }
9821443 ],
9831444 "default_config": {
from line 1790
13291790
13301791 - `configs: array of BetaManagedAgentsAgentToolConfig`
13311792
1332 - `enabled: boolean`
1333
1334 - `name: "bash" or "edit" or "read" or 5 more`
1335
1336 Built-in agent tool identifier.
1337
1338 - `"bash"`
1339
1340 - `"edit"`
1341
1342 - `"read"`
1343
1344 - `"write"`
1345
1346 - `"glob"`
1347
1348 - `"grep"`
1349
1350 - `"web_fetch"`
1351
1352 - `"web_search"`
1353
1354 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1355
1356 Permission policy for tool execution.
1357
1358 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1359
1360 Tool calls are automatically approved without user confirmation.
1361
1362 - `type: "always_allow"`
1363
1364 - `"always_allow"`
1365
1366 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1367
1368 Tool calls require user confirmation before execution.
1369
1370 - `type: "always_ask"`
1371
1372 - `"always_ask"`
1793 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
1794
1795 Configuration for the bash tool.
1796
1797 - `enabled: boolean`
1798
1799 - `name: "bash"`
1800
1801 - `"bash"`
1802
1803 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1804
1805 Permission policy for tool execution.
1806
1807 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1808
1809 Tool calls are automatically approved without user confirmation.
1810
1811 - `type: "always_allow"`
1812
1813 - `"always_allow"`
1814
1815 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1816
1817 Tool calls require user confirmation before execution.
1818
1819 - `type: "always_ask"`
1820
1821 - `"always_ask"`
1822
1823 - `type: "bash"`
1824
1825 - `"bash"`
1826
1827 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
1828
1829 Configuration for the edit tool.
1830
1831 - `enabled: boolean`
1832
1833 - `name: "edit"`
1834
1835 - `"edit"`
1836
1837 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1838
1839 Permission policy for tool execution.
1840
1841 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1842
1843 Tool calls are automatically approved without user confirmation.
1844
1845 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1846
1847 Tool calls require user confirmation before execution.
1848
1849 - `type: "edit"`
1850
1851 - `"edit"`
1852
1853 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
1854
1855 Configuration for the read tool.
1856
1857 - `enabled: boolean`
1858
1859 - `name: "read"`
1860
1861 - `"read"`
1862
1863 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1864
1865 Permission policy for tool execution.
1866
1867 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1868
1869 Tool calls are automatically approved without user confirmation.
1870
1871 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1872
1873 Tool calls require user confirmation before execution.
1874
1875 - `type: "read"`
1876
1877 - `"read"`
1878
1879 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
1880
1881 Configuration for the write tool.
1882
1883 - `enabled: boolean`
1884
1885 - `name: "write"`
1886
1887 - `"write"`
1888
1889 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1890
1891 Permission policy for tool execution.
1892
1893 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1894
1895 Tool calls are automatically approved without user confirmation.
1896
1897 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1898
1899 Tool calls require user confirmation before execution.
1900
1901 - `type: "write"`
1902
1903 - `"write"`
1904
1905 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
1906
1907 Configuration for the glob tool.
1908
1909 - `enabled: boolean`
1910
1911 - `name: "glob"`
1912
1913 - `"glob"`
1914
1915 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1916
1917 Permission policy for tool execution.
1918
1919 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1920
1921 Tool calls are automatically approved without user confirmation.
1922
1923 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1924
1925 Tool calls require user confirmation before execution.
1926
1927 - `type: "glob"`
1928
1929 - `"glob"`
1930
1931 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
1932
1933 Configuration for the grep tool.
1934
1935 - `enabled: boolean`
1936
1937 - `name: "grep"`
1938
1939 - `"grep"`
1940
1941 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1942
1943 Permission policy for tool execution.
1944
1945 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1946
1947 Tool calls are automatically approved without user confirmation.
1948
1949 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1950
1951 Tool calls require user confirmation before execution.
1952
1953 - `type: "grep"`
1954
1955 - `"grep"`
1956
1957 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
1958
1959 Configuration for the web_fetch tool.
1960
1961 - `enabled: boolean`
1962
1963 - `name: "web_fetch"`
1964
1965 - `"web_fetch"`
1966
1967 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1968
1969 Permission policy for tool execution.
1970
1971 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1972
1973 Tool calls are automatically approved without user confirmation.
1974
1975 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1976
1977 Tool calls require user confirmation before execution.
1978
1979 - `type: "web_fetch"`
1980
1981 - `"web_fetch"`
1982
1983 - `allowed_domains: optional array of string`
1984
1985 - `blocked_domains: optional array of string`
1986
1987 - `max_content_tokens: optional number or null`
1988
1989 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
1990
1991 Configuration for the web_search tool.
1992
1993 - `enabled: boolean`
1994
1995 - `name: "web_search"`
1996
1997 - `"web_search"`
1998
1999 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
2000
2001 Permission policy for tool execution.
2002
2003 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
2004
2005 Tool calls are automatically approved without user confirmation.
2006
2007 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
2008
2009 Tool calls require user confirmation before execution.
2010
2011 - `type: "web_search"`
2012
2013 - `"web_search"`
2014
2015 - `allowed_domains: optional array of string`
2016
2017 - `blocked_domains: optional array of string`
2018
2019 - `user_location: optional BetaManagedAgentsUserLocation or null`
2020
2021 Approximate user location for search result localization.
2022
2023 - `type: "approximate"`
2024
2025 Location precision. Only "approximate" is supported.
2026
2027 - `"approximate"`
2028
2029 - `city: optional string or null`
2030
2031 City name.
2032
2033 - `country: optional string or null`
2034
2035 Two-letter ISO 3166-1 country code, uppercase.
2036
2037 - `region: optional string or null`
2038
2039 Region or state name.
2040
2041 - `timezone: optional string or null`
2042
2043 IANA timezone identifier, e.g. "America/Los_Angeles".
13732044
13742045 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
13752046
from line 2217
15462217 "name": "bash",
15472218 "permission_policy": {
15482219 "type": "always_allow"
1549 }
2220 },
2221 "type": "bash"
15502222 }
15512223 ],
15522224 "default_config": {
from line 2561
18892561
18902562 - `configs: array of BetaManagedAgentsAgentToolConfig`
18912563
1892 - `enabled: boolean`
1893
1894 - `name: "bash" or "edit" or "read" or 5 more`
1895
1896 Built-in agent tool identifier.
1897
1898 - `"bash"`
1899
1900 - `"edit"`
1901
1902 - `"read"`
1903
1904 - `"write"`
1905
1906 - `"glob"`
1907
1908 - `"grep"`
1909
1910 - `"web_fetch"`
1911
1912 - `"web_search"`
1913
1914 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
1915
1916 Permission policy for tool execution.
1917
1918 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
1919
1920 Tool calls are automatically approved without user confirmation.
1921
1922 - `type: "always_allow"`
1923
1924 - `"always_allow"`
1925
1926 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
1927
1928 Tool calls require user confirmation before execution.
1929
1930 - `type: "always_ask"`
1931
1932 - `"always_ask"`
2564 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
2565
2566 Configuration for the bash tool.
2567
2568 - `enabled: boolean`
2569
2570 - `name: "bash"`
2571
2572 - `"bash"`
2573
2574 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
2575
2576 Permission policy for tool execution.
2577
2578 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
2579
2580 Tool calls are automatically approved without user confirmation.
2581
2582 - `type: "always_allow"`
2583
2584 - `"always_allow"`
2585
2586 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
2587
2588 Tool calls require user confirmation before execution.
2589
2590 - `type: "always_ask"`
2591
2592 - `"always_ask"`
2593
2594 - `type: "bash"`
2595
2596 - `"bash"`
2597
2598 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
2599
2600 Configuration for the edit tool.
2601
2602 - `enabled: boolean`
2603
2604 - `name: "edit"`
2605
2606 - `"edit"`
2607
2608 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
2609
2610 Permission policy for tool execution.
2611
2612 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
2613
2614 Tool calls are automatically approved without user confirmation.
2615
2616 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
2617
2618 Tool calls require user confirmation before execution.
2619
2620 - `type: "edit"`
2621
2622 - `"edit"`
2623
2624 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
2625
2626 Configuration for the read tool.
2627
2628 - `enabled: boolean`
2629
2630 - `name: "read"`
2631
2632 - `"read"`
2633
2634 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
2635
2636 Permission policy for tool execution.
2637
2638 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
2639
2640 Tool calls are automatically approved without user confirmation.
2641
2642 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
2643
2644 Tool calls require user confirmation before execution.
2645
2646 - `type: "read"`
2647
2648 - `"read"`
2649
2650 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
2651
2652 Configuration for the write tool.
2653
2654 - `enabled: boolean`
2655
2656 - `name: "write"`
2657
2658 - `"write"`
2659
2660 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
2661
2662 Permission policy for tool execution.
2663
2664 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
2665
2666 Tool calls are automatically approved without user confirmation.
2667
2668 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
2669
2670 Tool calls require user confirmation before execution.
2671
2672 - `type: "write"`
2673
2674 - `"write"`
2675
2676 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
2677
2678 Configuration for the glob tool.
2679
2680 - `enabled: boolean`
2681
2682 - `name: "glob"`
2683
2684 - `"glob"`
2685
2686 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
2687
2688 Permission policy for tool execution.
2689
2690 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
2691
2692 Tool calls are automatically approved without user confirmation.
2693
2694 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
2695
2696 Tool calls require user confirmation before execution.
2697
2698 - `type: "glob"`
2699
2700 - `"glob"`
2701
2702 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
2703
2704 Configuration for the grep tool.
2705
2706 - `enabled: boolean`
2707
2708 - `name: "grep"`
2709
2710 - `"grep"`
2711
2712 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
2713
2714 Permission policy for tool execution.
2715
2716 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
2717
2718 Tool calls are automatically approved without user confirmation.
2719
2720 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
2721
2722 Tool calls require user confirmation before execution.
2723
2724 - `type: "grep"`
2725
2726 - `"grep"`
2727
2728 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
2729
2730 Configuration for the web_fetch tool.
2731
2732 - `enabled: boolean`
2733
2734 - `name: "web_fetch"`
2735
2736 - `"web_fetch"`
2737
2738 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
2739
2740 Permission policy for tool execution.
2741
2742 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
2743
2744 Tool calls are automatically approved without user confirmation.
2745
2746 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
2747
2748 Tool calls require user confirmation before execution.
2749
2750 - `type: "web_fetch"`
2751
2752 - `"web_fetch"`
2753
2754 - `allowed_domains: optional array of string`
2755
2756 - `blocked_domains: optional array of string`
2757
2758 - `max_content_tokens: optional number or null`
2759
2760 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
2761
2762 Configuration for the web_search tool.
2763
2764 - `enabled: boolean`
2765
2766 - `name: "web_search"`
2767
2768 - `"web_search"`
2769
2770 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
2771
2772 Permission policy for tool execution.
2773
2774 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
2775
2776 Tool calls are automatically approved without user confirmation.
2777
2778 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
2779
2780 Tool calls require user confirmation before execution.
2781
2782 - `type: "web_search"`
2783
2784 - `"web_search"`
2785
2786 - `allowed_domains: optional array of string`
2787
2788 - `blocked_domains: optional array of string`
2789
2790 - `user_location: optional BetaManagedAgentsUserLocation or null`
2791
2792 Approximate user location for search result localization.
2793
2794 - `type: "approximate"`
2795
2796 Location precision. Only "approximate" is supported.
2797
2798 - `"approximate"`
2799
2800 - `city: optional string or null`
2801
2802 City name.
2803
2804 - `country: optional string or null`
2805
2806 Two-letter ISO 3166-1 country code, uppercase.
2807
2808 - `region: optional string or null`
2809
2810 Region or state name.
2811
2812 - `timezone: optional string or null`
2813
2814 IANA timezone identifier, e.g. "America/Los_Angeles".
19332815
19342816 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
19352817
from line 2982
21002982 "name": "bash",
21012983 "permission_policy": {
21022984 "type": "always_allow"
2103 }
2985 },
2986 "type": "bash"
21042987 }
21052988 ],
21062989 "default_config": {
from line 3375
24923375
24933376 Per-tool configuration overrides.
24943377
2495 - `name: "bash" or "edit" or "read" or 5 more`
2496
2497 Built-in agent tool identifier.
2498
2499 - `"bash"`
2500
2501 - `"edit"`
2502
2503 - `"read"`
2504
2505 - `"write"`
2506
2507 - `"glob"`
2508
2509 - `"grep"`
2510
2511 - `"web_fetch"`
2512
2513 - `"web_search"`
3378 - `BetaManagedAgentsBashToolConfigParams object { name, enabled, permission_policy, type }`
3379
3380 Configuration override for the bash tool.
3381
3382 - `name: "bash"`
3383
3384 Must be "bash".
3385
3386 - `"bash"`
3387
3388 - `enabled: optional boolean or null`
3389
3390 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
3391
3392 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
3393
3394 Permission policy for tool execution.
3395
3396 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
3397
3398 Tool calls are automatically approved without user confirmation.
3399
3400 - `type: "always_allow"`
3401
3402 - `"always_allow"`
3403
3404 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
3405
3406 Tool calls require user confirmation before execution.
3407
3408 - `type: "always_ask"`
3409
3410 - `"always_ask"`
3411
3412 - `type: optional "bash"`
3413
3414 - `"bash"`
3415
3416 - `BetaManagedAgentsEditToolConfigParams object { name, enabled, permission_policy, type }`
3417
3418 Configuration override for the edit tool.
3419
3420 - `name: "edit"`
3421
3422 Must be "edit".
3423
3424 - `"edit"`
3425
3426 - `enabled: optional boolean or null`
3427
3428 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
3429
3430 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
3431
3432 Permission policy for tool execution.
3433
3434 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
3435
3436 Tool calls are automatically approved without user confirmation.
3437
3438 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
3439
3440 Tool calls require user confirmation before execution.
3441
3442 - `type: optional "edit"`
3443
3444 - `"edit"`
3445
3446 - `BetaManagedAgentsReadToolConfigParams object { name, enabled, permission_policy, type }`
3447
3448 Configuration override for the read tool.
3449
3450 - `name: "read"`
3451
3452 Must be "read".
3453
3454 - `"read"`
3455
3456 - `enabled: optional boolean or null`
3457
3458 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
3459
3460 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
3461
3462 Permission policy for tool execution.
3463
3464 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
3465
3466 Tool calls are automatically approved without user confirmation.
3467
3468 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
3469
3470 Tool calls require user confirmation before execution.
3471
3472 - `type: optional "read"`
3473
3474 - `"read"`
3475
3476 - `BetaManagedAgentsWriteToolConfigParams object { name, enabled, permission_policy, type }`
3477
3478 Configuration override for the write tool.
3479
3480 - `name: "write"`
3481
3482 Must be "write".
3483
3484 - `"write"`
3485
3486 - `enabled: optional boolean or null`
3487
3488 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
3489
3490 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
3491
3492 Permission policy for tool execution.
3493
3494 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
3495
3496 Tool calls are automatically approved without user confirmation.
3497
3498 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
3499
3500 Tool calls require user confirmation before execution.
3501
3502 - `type: optional "write"`
3503
3504 - `"write"`
3505
3506 - `BetaManagedAgentsGlobToolConfigParams object { name, enabled, permission_policy, type }`
3507
3508 Configuration override for the glob tool.
3509
3510 - `name: "glob"`
3511
3512 Must be "glob".
3513
3514 - `"glob"`
3515
3516 - `enabled: optional boolean or null`
3517
3518 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
3519
3520 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
3521
3522 Permission policy for tool execution.
3523
3524 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
3525
3526 Tool calls are automatically approved without user confirmation.
3527
3528 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
3529
3530 Tool calls require user confirmation before execution.
3531
3532 - `type: optional "glob"`
3533
3534 - `"glob"`
3535
3536 - `BetaManagedAgentsGrepToolConfigParams object { name, enabled, permission_policy, type }`
3537
3538 Configuration override for the grep tool.
3539
3540 - `name: "grep"`
3541
3542 Must be "grep".
3543
3544 - `"grep"`
3545
3546 - `enabled: optional boolean or null`
3547
3548 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
3549
3550 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
3551
3552 Permission policy for tool execution.
3553
3554 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
3555
3556 Tool calls are automatically approved without user confirmation.
3557
3558 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
3559
3560 Tool calls require user confirmation before execution.
3561
3562 - `type: optional "grep"`
3563
3564 - `"grep"`
3565
3566 - `BetaManagedAgentsWebFetchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
3567
3568 Configuration override for the web_fetch tool.
3569
3570 - `name: "web_fetch"`
3571
3572 Must be "web_fetch".
3573
3574 - `"web_fetch"`
3575
3576 - `allowed_domains: optional array of string`
3577
3578 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.
3579
3580 - `blocked_domains: optional array of string`
3581
3582 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.
3583
3584 - `enabled: optional boolean or null`
3585
3586 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
3587
3588 - `max_content_tokens: optional number or null`
3589
3590 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.
3591
3592 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
3593
3594 Permission policy for tool execution.
3595
3596 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
3597
3598 Tool calls are automatically approved without user confirmation.
3599
3600 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
3601
3602 Tool calls require user confirmation before execution.
3603
3604 - `type: optional "web_fetch"`
3605
3606 - `"web_fetch"`
3607
3608 - `BetaManagedAgentsWebSearchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
3609
3610 Configuration override for the web_search tool.
3611
3612 - `name: "web_search"`
3613
3614 Must be "web_search".
3615
3616 - `"web_search"`
3617
3618 - `allowed_domains: optional array of string`
3619
3620 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.
3621
3622 - `blocked_domains: optional array of string`
3623
3624 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.
3625
3626 - `enabled: optional boolean or null`
3627
3628 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
3629
3630 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
3631
3632 Permission policy for tool execution.
3633
3634 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
3635
3636 Tool calls are automatically approved without user confirmation.
3637
3638 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
3639
3640 Tool calls require user confirmation before execution.
3641
3642 - `type: optional "web_search"`
3643
3644 - `"web_search"`
3645
3646 - `user_location: optional BetaManagedAgentsUserLocation or null`
3647
3648 Approximate user location for search result localization.
3649
3650 - `type: "approximate"`
3651
3652 Location precision. Only "approximate" is supported.
3653
3654 - `"approximate"`
3655
3656 - `city: optional string or null`
3657
3658 City name.
3659
3660 - `country: optional string or null`
3661
3662 Two-letter ISO 3166-1 country code, uppercase.
3663
3664 - `region: optional string or null`
3665
3666 Region or state name.
3667
3668 - `timezone: optional string or null`
3669
3670 IANA timezone identifier, e.g. "America/Los_Angeles".
3671
3672 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`
3673
3674 Default configuration for all tools in a toolset.
25143675
25153676 - `enabled: optional boolean or null`
25163677
2517 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
3678 Whether tools are enabled and available to Claude by default. Defaults to true if not specified.
25183679
25193680 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
25203681
from line 3685
25243685
25253686 Tool calls are automatically approved without user confirmation.
25263687
2527 - `type: "always_allow"`
2528
2529 - `"always_allow"`
2530
25313688 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
25323689
25333690 Tool calls require user confirmation before execution.
25343691
2535 - `type: "always_ask"`
2536
2537 - `"always_ask"`
2538
2539 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`
2540
2541 Default configuration for all tools in a toolset.
3692 - `BetaManagedAgentsMCPToolsetParams object { mcp_server_name, type, configs, default_config }`
3693
3694 Configuration for tools from an MCP server defined in `mcp_servers`.
3695
3696 - `mcp_server_name: string`
3697
3698 Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.
3699
3700 - `type: "mcp_toolset"`
3701
3702 - `"mcp_toolset"`
3703
3704 - `configs: optional array of BetaManagedAgentsMCPToolConfigParams`
3705
3706 Per-tool configuration overrides.
3707
3708 - `name: string`
3709
3710 Name of the MCP tool to configure. 1-128 characters.
25423711
25433712 - `enabled: optional boolean or null`
25443713
2545 Whether tools are enabled and available to Claude by default. Defaults to true if not specified.
3714 Whether this tool is enabled. Overrides the `default_config` setting.
25463715
25473716 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
25483717
from line 3725
25563725
25573726 Tool calls require user confirmation before execution.
25583727
2559 - `BetaManagedAgentsMCPToolsetParams object { mcp_server_name, type, configs, default_config }`
2560
2561 Configuration for tools from an MCP server defined in `mcp_servers`.
2562
2563 - `mcp_server_name: string`
2564
2565 Name of the MCP server. Must match a server name from the mcp_servers array. 1-255 characters.
2566
2567 - `type: "mcp_toolset"`
2568
2569 - `"mcp_toolset"`
2570
2571 - `configs: optional array of BetaManagedAgentsMCPToolConfigParams`
2572
2573 Per-tool configuration overrides.
2574
2575 - `name: string`
2576
2577 Name of the MCP tool to configure. 1-128 characters.
3728 - `default_config: optional BetaManagedAgentsMCPToolsetDefaultConfigParams or null`
3729
3730 Default configuration for all tools from an MCP server.
25783731
25793732 - `enabled: optional boolean or null`
25803733
2581 Whether this tool is enabled. Overrides the `default_config` setting.
3734 Whether tools are enabled by default. Defaults to true if not specified.
25823735
25833736 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
25843737
from line 3745
25923745
25933746 Tool calls require user confirmation before execution.
25943747
2595 - `default_config: optional BetaManagedAgentsMCPToolsetDefaultConfigParams or null`
2596
2597 Default configuration for all tools from an MCP server.
2598
2599 - `enabled: optional boolean or null`
2600
2601 Whether tools are enabled by default. Defaults to true if not specified.
2602
2603 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
2604
2605 Permission policy for tool execution.
2606
2607 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
2608
2609 Tool calls are automatically approved without user confirmation.
2610
2611 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
2612
2613 Tool calls require user confirmation before execution.
2614
26153748 - `BetaManagedAgentsCustomToolParams object { description, input_schema, name, type }`
26163749
26173750 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 4005
28724005
28734006 - `configs: array of BetaManagedAgentsAgentToolConfig`
28744007
2875 - `enabled: boolean`
2876
2877 - `name: "bash" or "edit" or "read" or 5 more`
2878
2879 Built-in agent tool identifier.
2880
2881 - `"bash"`
2882
2883 - `"edit"`
2884
2885 - `"read"`
2886
2887 - `"write"`
2888
2889 - `"glob"`
2890
2891 - `"grep"`
2892
2893 - `"web_fetch"`
2894
2895 - `"web_search"`
2896
2897 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
2898
2899 Permission policy for tool execution.
2900
2901 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
2902
2903 Tool calls are automatically approved without user confirmation.
2904
2905 - `type: "always_allow"`
2906
2907 - `"always_allow"`
2908
2909 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
2910
2911 Tool calls require user confirmation before execution.
2912
2913 - `type: "always_ask"`
2914
2915 - `"always_ask"`
4008 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
4009
4010 Configuration for the bash tool.
4011
4012 - `enabled: boolean`
4013
4014 - `name: "bash"`
4015
4016 - `"bash"`
4017
4018 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4019
4020 Permission policy for tool execution.
4021
4022 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4023
4024 Tool calls are automatically approved without user confirmation.
4025
4026 - `type: "always_allow"`
4027
4028 - `"always_allow"`
4029
4030 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4031
4032 Tool calls require user confirmation before execution.
4033
4034 - `type: "always_ask"`
4035
4036 - `"always_ask"`
4037
4038 - `type: "bash"`
4039
4040 - `"bash"`
4041
4042 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
4043
4044 Configuration for the edit tool.
4045
4046 - `enabled: boolean`
4047
4048 - `name: "edit"`
4049
4050 - `"edit"`
4051
4052 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4053
4054 Permission policy for tool execution.
4055
4056 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4057
4058 Tool calls are automatically approved without user confirmation.
4059
4060 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4061
4062 Tool calls require user confirmation before execution.
4063
4064 - `type: "edit"`
4065
4066 - `"edit"`
4067
4068 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
4069
4070 Configuration for the read tool.
4071
4072 - `enabled: boolean`
4073
4074 - `name: "read"`
4075
4076 - `"read"`
4077
4078 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4079
4080 Permission policy for tool execution.
4081
4082 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4083
4084 Tool calls are automatically approved without user confirmation.
4085
4086 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4087
4088 Tool calls require user confirmation before execution.
4089
4090 - `type: "read"`
4091
4092 - `"read"`
4093
4094 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
4095
4096 Configuration for the write tool.
4097
4098 - `enabled: boolean`
4099
4100 - `name: "write"`
4101
4102 - `"write"`
4103
4104 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4105
4106 Permission policy for tool execution.
4107
4108 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4109
4110 Tool calls are automatically approved without user confirmation.
4111
4112 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4113
4114 Tool calls require user confirmation before execution.
4115
4116 - `type: "write"`
4117
4118 - `"write"`
4119
4120 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
4121
4122 Configuration for the glob tool.
4123
4124 - `enabled: boolean`
4125
4126 - `name: "glob"`
4127
4128 - `"glob"`
4129
4130 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4131
4132 Permission policy for tool execution.
4133
4134 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4135
4136 Tool calls are automatically approved without user confirmation.
4137
4138 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4139
4140 Tool calls require user confirmation before execution.
4141
4142 - `type: "glob"`
4143
4144 - `"glob"`
4145
4146 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
4147
4148 Configuration for the grep tool.
4149
4150 - `enabled: boolean`
4151
4152 - `name: "grep"`
4153
4154 - `"grep"`
4155
4156 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4157
4158 Permission policy for tool execution.
4159
4160 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4161
4162 Tool calls are automatically approved without user confirmation.
4163
4164 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4165
4166 Tool calls require user confirmation before execution.
4167
4168 - `type: "grep"`
4169
4170 - `"grep"`
4171
4172 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
4173
4174 Configuration for the web_fetch tool.
4175
4176 - `enabled: boolean`
4177
4178 - `name: "web_fetch"`
4179
4180 - `"web_fetch"`
4181
4182 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4183
4184 Permission policy for tool execution.
4185
4186 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4187
4188 Tool calls are automatically approved without user confirmation.
4189
4190 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4191
4192 Tool calls require user confirmation before execution.
4193
4194 - `type: "web_fetch"`
4195
4196 - `"web_fetch"`
4197
4198 - `allowed_domains: optional array of string`
4199
4200 - `blocked_domains: optional array of string`
4201
4202 - `max_content_tokens: optional number or null`
4203
4204 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
4205
4206 Configuration for the web_search tool.
4207
4208 - `enabled: boolean`
4209
4210 - `name: "web_search"`
4211
4212 - `"web_search"`
4213
4214 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4215
4216 Permission policy for tool execution.
4217
4218 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4219
4220 Tool calls are automatically approved without user confirmation.
4221
4222 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4223
4224 Tool calls require user confirmation before execution.
4225
4226 - `type: "web_search"`
4227
4228 - `"web_search"`
4229
4230 - `allowed_domains: optional array of string`
4231
4232 - `blocked_domains: optional array of string`
4233
4234 - `user_location: optional BetaManagedAgentsUserLocation or null`
4235
4236 Approximate user location for search result localization.
4237
4238 - `type: "approximate"`
4239
4240 Location precision. Only "approximate" is supported.
4241
4242 - `"approximate"`
4243
4244 - `city: optional string or null`
4245
4246 City name.
4247
4248 - `country: optional string or null`
4249
4250 Two-letter ISO 3166-1 country code, uppercase.
4251
4252 - `region: optional string or null`
4253
4254 Region or state name.
4255
4256 - `timezone: optional string or null`
4257
4258 IANA timezone identifier, e.g. "America/Los_Angeles".
29164259
29174260 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
29184261
from line 4432
30894432 "name": "bash",
30904433 "permission_policy": {
30914434 "type": "always_allow"
3092 }
4435 },
4436 "type": "bash"
30934437 }
30944438 ],
30954439 "default_config": {
from line 4767
34234767
34244768 - `configs: array of BetaManagedAgentsAgentToolConfig`
34254769
3426 - `enabled: boolean`
3427
3428 - `name: "bash" or "edit" or "read" or 5 more`
3429
3430 Built-in agent tool identifier.
3431
3432 - `"bash"`
3433
3434 - `"edit"`
3435
3436 - `"read"`
3437
3438 - `"write"`
3439
3440 - `"glob"`
3441
3442 - `"grep"`
3443
3444 - `"web_fetch"`
3445
3446 - `"web_search"`
3447
3448 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
3449
3450 Permission policy for tool execution.
3451
3452 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
3453
3454 Tool calls are automatically approved without user confirmation.
3455
3456 - `type: "always_allow"`
3457
3458 - `"always_allow"`
3459
3460 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
3461
3462 Tool calls require user confirmation before execution.
3463
3464 - `type: "always_ask"`
3465
3466 - `"always_ask"`
4770 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
4771
4772 Configuration for the bash tool.
4773
4774 - `enabled: boolean`
4775
4776 - `name: "bash"`
4777
4778 - `"bash"`
4779
4780 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4781
4782 Permission policy for tool execution.
4783
4784 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4785
4786 Tool calls are automatically approved without user confirmation.
4787
4788 - `type: "always_allow"`
4789
4790 - `"always_allow"`
4791
4792 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4793
4794 Tool calls require user confirmation before execution.
4795
4796 - `type: "always_ask"`
4797
4798 - `"always_ask"`
4799
4800 - `type: "bash"`
4801
4802 - `"bash"`
4803
4804 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
4805
4806 Configuration for the edit tool.
4807
4808 - `enabled: boolean`
4809
4810 - `name: "edit"`
4811
4812 - `"edit"`
4813
4814 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4815
4816 Permission policy for tool execution.
4817
4818 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4819
4820 Tool calls are automatically approved without user confirmation.
4821
4822 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4823
4824 Tool calls require user confirmation before execution.
4825
4826 - `type: "edit"`
4827
4828 - `"edit"`
4829
4830 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
4831
4832 Configuration for the read tool.
4833
4834 - `enabled: boolean`
4835
4836 - `name: "read"`
4837
4838 - `"read"`
4839
4840 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4841
4842 Permission policy for tool execution.
4843
4844 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4845
4846 Tool calls are automatically approved without user confirmation.
4847
4848 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4849
4850 Tool calls require user confirmation before execution.
4851
4852 - `type: "read"`
4853
4854 - `"read"`
4855
4856 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
4857
4858 Configuration for the write tool.
4859
4860 - `enabled: boolean`
4861
4862 - `name: "write"`
4863
4864 - `"write"`
4865
4866 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4867
4868 Permission policy for tool execution.
4869
4870 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4871
4872 Tool calls are automatically approved without user confirmation.
4873
4874 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4875
4876 Tool calls require user confirmation before execution.
4877
4878 - `type: "write"`
4879
4880 - `"write"`
4881
4882 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
4883
4884 Configuration for the glob tool.
4885
4886 - `enabled: boolean`
4887
4888 - `name: "glob"`
4889
4890 - `"glob"`
4891
4892 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4893
4894 Permission policy for tool execution.
4895
4896 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4897
4898 Tool calls are automatically approved without user confirmation.
4899
4900 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4901
4902 Tool calls require user confirmation before execution.
4903
4904 - `type: "glob"`
4905
4906 - `"glob"`
4907
4908 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
4909
4910 Configuration for the grep tool.
4911
4912 - `enabled: boolean`
4913
4914 - `name: "grep"`
4915
4916 - `"grep"`
4917
4918 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4919
4920 Permission policy for tool execution.
4921
4922 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4923
4924 Tool calls are automatically approved without user confirmation.
4925
4926 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4927
4928 Tool calls require user confirmation before execution.
4929
4930 - `type: "grep"`
4931
4932 - `"grep"`
4933
4934 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
4935
4936 Configuration for the web_fetch tool.
4937
4938 - `enabled: boolean`
4939
4940 - `name: "web_fetch"`
4941
4942 - `"web_fetch"`
4943
4944 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4945
4946 Permission policy for tool execution.
4947
4948 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4949
4950 Tool calls are automatically approved without user confirmation.
4951
4952 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4953
4954 Tool calls require user confirmation before execution.
4955
4956 - `type: "web_fetch"`
4957
4958 - `"web_fetch"`
4959
4960 - `allowed_domains: optional array of string`
4961
4962 - `blocked_domains: optional array of string`
4963
4964 - `max_content_tokens: optional number or null`
4965
4966 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
4967
4968 Configuration for the web_search tool.
4969
4970 - `enabled: boolean`
4971
4972 - `name: "web_search"`
4973
4974 - `"web_search"`
4975
4976 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4977
4978 Permission policy for tool execution.
4979
4980 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4981
4982 Tool calls are automatically approved without user confirmation.
4983
4984 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4985
4986 Tool calls require user confirmation before execution.
4987
4988 - `type: "web_search"`
4989
4990 - `"web_search"`
4991
4992 - `allowed_domains: optional array of string`
4993
4994 - `blocked_domains: optional array of string`
4995
4996 - `user_location: optional BetaManagedAgentsUserLocation or null`
4997
4998 Approximate user location for search result localization.
4999
5000 - `type: "approximate"`
5001
5002 Location precision. Only "approximate" is supported.
5003
5004 - `"approximate"`
5005
5006 - `city: optional string or null`
5007
5008 City name.
5009
5010 - `country: optional string or null`
5011
5012 Two-letter ISO 3166-1 country code, uppercase.
5013
5014 - `region: optional string or null`
5015
5016 Region or state name.
5017
5018 - `timezone: optional string or null`
5019
5020 IANA timezone identifier, e.g. "America/Los_Angeles".
34675021
34685022 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
34695023
from line 5189
36355189 "name": "bash",
36365190 "permission_policy": {
36375191 "type": "always_allow"
3638 }
5192 },
5193 "type": "bash"
36395194 }
36405195 ],
36415196 "default_config": {
from line 5452
38975452
38985453 - `configs: array of BetaManagedAgentsAgentToolConfig`
38995454
5455 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
5456
5457 Configuration for the bash tool.
5458
5459 - `enabled: boolean`
5460
5461 - `name: "bash"`
5462
5463 - `"bash"`
5464
5465 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
5466
5467 Permission policy for tool execution.
5468
5469 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
5470
5471 Tool calls are automatically approved without user confirmation.
5472
5473 - `type: "always_allow"`
5474
5475 - `"always_allow"`
5476
5477 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
5478
5479 Tool calls require user confirmation before execution.
5480
5481 - `type: "always_ask"`
5482
5483 - `"always_ask"`
5484
5485 - `type: "bash"`
5486
5487 - `"bash"`
5488
5489 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
5490
5491 Configuration for the edit tool.
5492
5493 - `enabled: boolean`
5494
5495 - `name: "edit"`
5496
5497 - `"edit"`
5498
5499 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
5500
5501 Permission policy for tool execution.
5502
5503 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
5504
5505 Tool calls are automatically approved without user confirmation.
5506
5507 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
5508
5509 Tool calls require user confirmation before execution.
5510
5511 - `type: "edit"`
5512
5513 - `"edit"`
5514
5515 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
5516
5517 Configuration for the read tool.
5518
5519 - `enabled: boolean`
5520
5521 - `name: "read"`
5522
5523 - `"read"`
5524
5525 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
5526
5527 Permission policy for tool execution.
5528
5529 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
5530
5531 Tool calls are automatically approved without user confirmation.
5532
5533 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
5534
5535 Tool calls require user confirmation before execution.
5536
5537 - `type: "read"`
5538
5539 - `"read"`
5540
5541 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
5542
5543 Configuration for the write tool.
5544
5545 - `enabled: boolean`
5546
5547 - `name: "write"`
5548
5549 - `"write"`
5550
5551 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
5552
5553 Permission policy for tool execution.
5554
5555 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
5556
5557 Tool calls are automatically approved without user confirmation.
5558
5559 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
5560
5561 Tool calls require user confirmation before execution.
5562
5563 - `type: "write"`
5564
5565 - `"write"`
5566
5567 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
5568
5569 Configuration for the glob tool.
5570
5571 - `enabled: boolean`
5572
5573 - `name: "glob"`
5574
5575 - `"glob"`
5576
5577 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
5578
5579 Permission policy for tool execution.
5580
5581 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
5582
5583 Tool calls are automatically approved without user confirmation.
5584
5585 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
5586
5587 Tool calls require user confirmation before execution.
5588
5589 - `type: "glob"`
5590
5591 - `"glob"`
5592
5593 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
5594
5595 Configuration for the grep tool.
5596
5597 - `enabled: boolean`
5598
5599 - `name: "grep"`
5600
5601 - `"grep"`
5602
5603 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
5604
5605 Permission policy for tool execution.
5606
5607 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
5608
5609 Tool calls are automatically approved without user confirmation.
5610
5611 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
5612
5613 Tool calls require user confirmation before execution.
5614
5615 - `type: "grep"`
5616
5617 - `"grep"`
5618
5619 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
5620
5621 Configuration for the web_fetch tool.
5622
5623 - `enabled: boolean`
5624
5625 - `name: "web_fetch"`
5626
5627 - `"web_fetch"`
5628
5629 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
5630
5631 Permission policy for tool execution.
5632
5633 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
5634
5635 Tool calls are automatically approved without user confirmation.
5636
5637 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
5638
5639 Tool calls require user confirmation before execution.
5640
5641 - `type: "web_fetch"`
5642
5643 - `"web_fetch"`
5644
5645 - `allowed_domains: optional array of string`
5646
5647 - `blocked_domains: optional array of string`
5648
5649 - `max_content_tokens: optional number or null`
5650
5651 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
5652
5653 Configuration for the web_search tool.
5654
5655 - `enabled: boolean`
5656
5657 - `name: "web_search"`
5658
5659 - `"web_search"`
5660
5661 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
5662
5663 Permission policy for tool execution.
5664
5665 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
5666
5667 Tool calls are automatically approved without user confirmation.
5668
5669 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
5670
5671 Tool calls require user confirmation before execution.
5672
5673 - `type: "web_search"`
5674
5675 - `"web_search"`
5676
5677 - `allowed_domains: optional array of string`
5678
5679 - `blocked_domains: optional array of string`
5680
5681 - `user_location: optional BetaManagedAgentsUserLocation or null`
5682
5683 Approximate user location for search result localization.
5684
5685 - `type: "approximate"`
5686
5687 Location precision. Only "approximate" is supported.
5688
5689 - `"approximate"`
5690
5691 - `city: optional string or null`
5692
5693 City name.
5694
5695 - `country: optional string or null`
5696
5697 Two-letter ISO 3166-1 country code, uppercase.
5698
5699 - `region: optional string or null`
5700
5701 Region or state name.
5702
5703 - `timezone: optional string or null`
5704
5705 IANA timezone identifier, e.g. "America/Los_Angeles".
5706
5707 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
5708
5709 Resolved default configuration for agent tools.
5710
39005711 - `enabled: boolean`
39015712
3902 - `name: "bash" or "edit" or "read" or 5 more`
3903
3904 Built-in agent tool identifier.
3905
3906 - `"bash"`
3907
3908 - `"edit"`
3909
3910 - `"read"`
3911
3912 - `"write"`
3913
3914 - `"glob"`
3915
3916 - `"grep"`
3917
3918 - `"web_fetch"`
3919
3920 - `"web_search"`
3921
39225713 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
39235714
39245715 Permission policy for tool execution.
from line 5718
39275718
39285719 Tool calls are automatically approved without user confirmation.
39295720
3930 - `type: "always_allow"`
3931
3932 - `"always_allow"`
3933
39345721 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
39355722
39365723 Tool calls require user confirmation before execution.
39375724
3938 - `type: "always_ask"`
3939
3940 - `"always_ask"`
3941
3942 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
3943
3944 Resolved default configuration for agent tools.
5725 - `type: "agent_toolset_20260401"`
5726
5727 - `"agent_toolset_20260401"`
5728
5729 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`
5730
5731 - `configs: array of BetaManagedAgentsMCPToolConfig`
39455732
39465733 - `enabled: boolean`
39475734
5735 - `name: string`
5736
39485737 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
39495738
39505739 Permission policy for tool execution.
from line 5746
39575746
39585747 Tool calls require user confirmation before execution.
39595748
3960 - `type: "agent_toolset_20260401"`
3961
3962 - `"agent_toolset_20260401"`
3963
3964 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`
3965
3966 - `configs: array of BetaManagedAgentsMCPToolConfig`
5749 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
5750
5751 Resolved default configuration for all tools from an MCP server.
39675752
39685753 - `enabled: boolean`
39695754
3970 - `name: string`
3971
39725755 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
39735756
39745757 Permission policy for tool execution.
from line 5764
39815764
39825765 Tool calls require user confirmation before execution.
39835766
3984 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
3985
3986 Resolved default configuration for all tools from an MCP server.
3987
3988 - `enabled: boolean`
3989
3990 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
3991
3992 Permission policy for tool execution.
3993
3994 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
3995
3996 Tool calls are automatically approved without user confirmation.
3997
3998 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
3999
4000 Tool calls require user confirmation before execution.
4001
40025767 - `mcp_server_name: string`
40035768
40045769 - `type: "mcp_toolset"`
from line 5822
40575822
40585823### Beta Managed Agents Agent Tool Config
40595824
4060- `BetaManagedAgentsAgentToolConfig object { enabled, name, permission_policy }`
5825- `BetaManagedAgentsAgentToolConfig = BetaManagedAgentsBashToolConfig or BetaManagedAgentsEditToolConfig or BetaManagedAgentsReadToolConfig or 5 more`
40615826
40625827 Configuration for a specific agent tool.
40635828
5829 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
5830
5831 Configuration for the bash tool.
5832
5833 - `enabled: boolean`
5834
5835 - `name: "bash"`
5836
5837 - `"bash"`
5838
5839 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
5840
5841 Permission policy for tool execution.
5842
5843 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
5844
5845 Tool calls are automatically approved without user confirmation.
5846
5847 - `type: "always_allow"`
5848
5849 - `"always_allow"`
5850
5851 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
5852
5853 Tool calls require user confirmation before execution.
5854
5855 - `type: "always_ask"`
5856
5857 - `"always_ask"`
5858
5859 - `type: "bash"`
5860
5861 - `"bash"`
5862
5863 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
5864
5865 Configuration for the edit tool.
5866
5867 - `enabled: boolean`
5868
5869 - `name: "edit"`
5870
5871 - `"edit"`
5872
5873 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
5874
5875 Permission policy for tool execution.
5876
5877 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
5878
5879 Tool calls are automatically approved without user confirmation.
5880
5881 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
5882
5883 Tool calls require user confirmation before execution.
5884
5885 - `type: "edit"`
5886
5887 - `"edit"`
5888
5889 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
5890
5891 Configuration for the read tool.
5892
5893 - `enabled: boolean`
5894
5895 - `name: "read"`
5896
5897 - `"read"`
5898
5899 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
5900
5901 Permission policy for tool execution.
5902
5903 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
5904
5905 Tool calls are automatically approved without user confirmation.
5906
5907 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
5908
5909 Tool calls require user confirmation before execution.
5910
5911 - `type: "read"`
5912
5913 - `"read"`
5914
5915 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
5916
5917 Configuration for the write tool.
5918
5919 - `enabled: boolean`
5920
5921 - `name: "write"`
5922
5923 - `"write"`
5924
5925 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
5926
5927 Permission policy for tool execution.
5928
5929 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
5930
5931 Tool calls are automatically approved without user confirmation.
5932
5933 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
5934
5935 Tool calls require user confirmation before execution.
5936
5937 - `type: "write"`
5938
5939 - `"write"`
5940
5941 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
5942
5943 Configuration for the glob tool.
5944
5945 - `enabled: boolean`
5946
5947 - `name: "glob"`
5948
5949 - `"glob"`
5950
5951 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
5952
5953 Permission policy for tool execution.
5954
5955 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
5956
5957 Tool calls are automatically approved without user confirmation.
5958
5959 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
5960
5961 Tool calls require user confirmation before execution.
5962
5963 - `type: "glob"`
5964
5965 - `"glob"`
5966
5967 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
5968
5969 Configuration for the grep tool.
5970
5971 - `enabled: boolean`
5972
5973 - `name: "grep"`
5974
5975 - `"grep"`
5976
5977 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
5978
5979 Permission policy for tool execution.
5980
5981 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
5982
5983 Tool calls are automatically approved without user confirmation.
5984
5985 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
5986
5987 Tool calls require user confirmation before execution.
5988
5989 - `type: "grep"`
5990
5991 - `"grep"`
5992
5993 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
5994
5995 Configuration for the web_fetch tool.
5996
5997 - `enabled: boolean`
5998
5999 - `name: "web_fetch"`
6000
6001 - `"web_fetch"`
6002
6003 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
6004
6005 Permission policy for tool execution.
6006
6007 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6008
6009 Tool calls are automatically approved without user confirmation.
6010
6011 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6012
6013 Tool calls require user confirmation before execution.
6014
6015 - `type: "web_fetch"`
6016
6017 - `"web_fetch"`
6018
6019 - `allowed_domains: optional array of string`
6020
6021 - `blocked_domains: optional array of string`
6022
6023 - `max_content_tokens: optional number or null`
6024
6025 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
6026
6027 Configuration for the web_search tool.
6028
6029 - `enabled: boolean`
6030
6031 - `name: "web_search"`
6032
6033 - `"web_search"`
6034
6035 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
6036
6037 Permission policy for tool execution.
6038
6039 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6040
6041 Tool calls are automatically approved without user confirmation.
6042
6043 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6044
6045 Tool calls require user confirmation before execution.
6046
6047 - `type: "web_search"`
6048
6049 - `"web_search"`
6050
6051 - `allowed_domains: optional array of string`
6052
6053 - `blocked_domains: optional array of string`
6054
6055 - `user_location: optional BetaManagedAgentsUserLocation or null`
6056
6057 Approximate user location for search result localization.
6058
6059 - `type: "approximate"`
6060
6061 Location precision. Only "approximate" is supported.
6062
6063 - `"approximate"`
6064
6065 - `city: optional string or null`
6066
6067 City name.
6068
6069 - `country: optional string or null`
6070
6071 Two-letter ISO 3166-1 country code, uppercase.
6072
6073 - `region: optional string or null`
6074
6075 Region or state name.
6076
6077 - `timezone: optional string or null`
6078
6079 IANA timezone identifier, e.g. "America/Los_Angeles".
6080
6081### Beta Managed Agents Agent Tool Config Params
6082
6083- `BetaManagedAgentsAgentToolConfigParams = BetaManagedAgentsBashToolConfigParams or BetaManagedAgentsEditToolConfigParams or BetaManagedAgentsReadToolConfigParams or 5 more`
6084
6085 Configuration override for a specific tool within a toolset.
6086
6087 - `BetaManagedAgentsBashToolConfigParams object { name, enabled, permission_policy, type }`
6088
6089 Configuration override for the bash tool.
6090
6091 - `name: "bash"`
6092
6093 Must be "bash".
6094
6095 - `"bash"`
6096
6097 - `enabled: optional boolean or null`
6098
6099 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
6100
6101 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
6102
6103 Permission policy for tool execution.
6104
6105 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6106
6107 Tool calls are automatically approved without user confirmation.
6108
6109 - `type: "always_allow"`
6110
6111 - `"always_allow"`
6112
6113 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6114
6115 Tool calls require user confirmation before execution.
6116
6117 - `type: "always_ask"`
6118
6119 - `"always_ask"`
6120
6121 - `type: optional "bash"`
6122
6123 - `"bash"`
6124
6125 - `BetaManagedAgentsEditToolConfigParams object { name, enabled, permission_policy, type }`
6126
6127 Configuration override for the edit tool.
6128
6129 - `name: "edit"`
6130
6131 Must be "edit".
6132
6133 - `"edit"`
6134
6135 - `enabled: optional boolean or null`
6136
6137 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
6138
6139 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
6140
6141 Permission policy for tool execution.
6142
6143 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6144
6145 Tool calls are automatically approved without user confirmation.
6146
6147 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6148
6149 Tool calls require user confirmation before execution.
6150
6151 - `type: optional "edit"`
6152
6153 - `"edit"`
6154
6155 - `BetaManagedAgentsReadToolConfigParams object { name, enabled, permission_policy, type }`
6156
6157 Configuration override for the read tool.
6158
6159 - `name: "read"`
6160
6161 Must be "read".
6162
6163 - `"read"`
6164
6165 - `enabled: optional boolean or null`
6166
6167 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
6168
6169 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
6170
6171 Permission policy for tool execution.
6172
6173 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6174
6175 Tool calls are automatically approved without user confirmation.
6176
6177 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6178
6179 Tool calls require user confirmation before execution.
6180
6181 - `type: optional "read"`
6182
6183 - `"read"`
6184
6185 - `BetaManagedAgentsWriteToolConfigParams object { name, enabled, permission_policy, type }`
6186
6187 Configuration override for the write tool.
6188
6189 - `name: "write"`
6190
6191 Must be "write".
6192
6193 - `"write"`
6194
6195 - `enabled: optional boolean or null`
6196
6197 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
6198
6199 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
6200
6201 Permission policy for tool execution.
6202
6203 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6204
6205 Tool calls are automatically approved without user confirmation.
6206
6207 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6208
6209 Tool calls require user confirmation before execution.
6210
6211 - `type: optional "write"`
6212
6213 - `"write"`
6214
6215 - `BetaManagedAgentsGlobToolConfigParams object { name, enabled, permission_policy, type }`
6216
6217 Configuration override for the glob tool.
6218
6219 - `name: "glob"`
6220
6221 Must be "glob".
6222
6223 - `"glob"`
6224
6225 - `enabled: optional boolean or null`
6226
6227 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
6228
6229 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
6230
6231 Permission policy for tool execution.
6232
6233 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6234
6235 Tool calls are automatically approved without user confirmation.
6236
6237 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6238
6239 Tool calls require user confirmation before execution.
6240
6241 - `type: optional "glob"`
6242
6243 - `"glob"`
6244
6245 - `BetaManagedAgentsGrepToolConfigParams object { name, enabled, permission_policy, type }`
6246
6247 Configuration override for the grep tool.
6248
6249 - `name: "grep"`
6250
6251 Must be "grep".
6252
6253 - `"grep"`
6254
6255 - `enabled: optional boolean or null`
6256
6257 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
6258
6259 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
6260
6261 Permission policy for tool execution.
6262
6263 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6264
6265 Tool calls are automatically approved without user confirmation.
6266
6267 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6268
6269 Tool calls require user confirmation before execution.
6270
6271 - `type: optional "grep"`
6272
6273 - `"grep"`
6274
6275 - `BetaManagedAgentsWebFetchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
6276
6277 Configuration override for the web_fetch tool.
6278
6279 - `name: "web_fetch"`
6280
6281 Must be "web_fetch".
6282
6283 - `"web_fetch"`
6284
6285 - `allowed_domains: optional array of string`
6286
6287 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.
6288
6289 - `blocked_domains: optional array of string`
6290
6291 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.
6292
6293 - `enabled: optional boolean or null`
6294
6295 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
6296
6297 - `max_content_tokens: optional number or null`
6298
6299 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.
6300
6301 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
6302
6303 Permission policy for tool execution.
6304
6305 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6306
6307 Tool calls are automatically approved without user confirmation.
6308
6309 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6310
6311 Tool calls require user confirmation before execution.
6312
6313 - `type: optional "web_fetch"`
6314
6315 - `"web_fetch"`
6316
6317 - `BetaManagedAgentsWebSearchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
6318
6319 Configuration override for the web_search tool.
6320
6321 - `name: "web_search"`
6322
6323 Must be "web_search".
6324
6325 - `"web_search"`
6326
6327 - `allowed_domains: optional array of string`
6328
6329 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.
6330
6331 - `blocked_domains: optional array of string`
6332
6333 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.
6334
6335 - `enabled: optional boolean or null`
6336
6337 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
6338
6339 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
6340
6341 Permission policy for tool execution.
6342
6343 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6344
6345 Tool calls are automatically approved without user confirmation.
6346
6347 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6348
6349 Tool calls require user confirmation before execution.
6350
6351 - `type: optional "web_search"`
6352
6353 - `"web_search"`
6354
6355 - `user_location: optional BetaManagedAgentsUserLocation or null`
6356
6357 Approximate user location for search result localization.
6358
6359 - `type: "approximate"`
6360
6361 Location precision. Only "approximate" is supported.
6362
6363 - `"approximate"`
6364
6365 - `city: optional string or null`
6366
6367 City name.
6368
6369 - `country: optional string or null`
6370
6371 Two-letter ISO 3166-1 country code, uppercase.
6372
6373 - `region: optional string or null`
6374
6375 Region or state name.
6376
6377 - `timezone: optional string or null`
6378
6379 IANA timezone identifier, e.g. "America/Los_Angeles".
6380
6381### Beta Managed Agents Agent Toolset Default Config
6382
6383- `BetaManagedAgentsAgentToolsetDefaultConfig object { enabled, permission_policy }`
6384
6385 Resolved default configuration for agent tools.
6386
40646387 - `enabled: boolean`
40656388
4066 - `name: "bash" or "edit" or "read" or 5 more`
4067
4068 Built-in agent tool identifier.
4069
4070 - `"bash"`
4071
4072 - `"edit"`
4073
4074 - `"read"`
4075
4076 - `"write"`
4077
4078 - `"glob"`
4079
4080 - `"grep"`
4081
4082 - `"web_fetch"`
4083
4084 - `"web_search"`
4085
40866389 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
40876390
40886391 Permission policy for tool execution.
from line 6406
41036406
41046407 - `"always_ask"`
41056408
4106### Beta Managed Agents Agent Tool Config Params
4107
4108- `BetaManagedAgentsAgentToolConfigParams object { name, enabled, permission_policy }`
4109
4110 Configuration override for a specific tool within a toolset.
4111
4112 - `name: "bash" or "edit" or "read" or 5 more`
4113
4114 Built-in agent tool identifier.
4115
4116 - `"bash"`
4117
4118 - `"edit"`
4119
4120 - `"read"`
4121
4122 - `"write"`
4123
4124 - `"glob"`
4125
4126 - `"grep"`
4127
4128 - `"web_fetch"`
4129
4130 - `"web_search"`
6409### Beta Managed Agents Agent Toolset Default Config Params
6410
6411- `BetaManagedAgentsAgentToolsetDefaultConfigParams object { enabled, permission_policy }`
6412
6413 Default configuration for all tools in a toolset.
41316414
41326415 - `enabled: optional boolean or null`
41336416
4134 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
6417 Whether tools are enabled and available to Claude by default. Defaults to true if not specified.
41356418
41366419 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
41376420
from line 6436
41536436
41546437 - `"always_ask"`
41556438
4156### Beta Managed Agents Agent Toolset Default Config
4157
4158- `BetaManagedAgentsAgentToolsetDefaultConfig object { enabled, permission_policy }`
4159
4160 Resolved default configuration for agent tools.
4161
4162 - `enabled: boolean`
4163
4164 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4165
4166 Permission policy for tool execution.
4167
4168 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4169
4170 Tool calls are automatically approved without user confirmation.
4171
4172 - `type: "always_allow"`
4173
4174 - `"always_allow"`
4175
4176 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4177
4178 Tool calls require user confirmation before execution.
4179
4180 - `type: "always_ask"`
4181
4182 - `"always_ask"`
4183
4184### Beta Managed Agents Agent Toolset Default Config Params
4185
4186- `BetaManagedAgentsAgentToolsetDefaultConfigParams object { enabled, permission_policy }`
4187
4188 Default configuration for all tools in a toolset.
4189
4190 - `enabled: optional boolean or null`
4191
4192 Whether tools are enabled and available to Claude by default. Defaults to true if not specified.
4193
4194 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
4195
4196 Permission policy for tool execution.
4197
4198 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4199
4200 Tool calls are automatically approved without user confirmation.
4201
4202 - `type: "always_allow"`
4203
4204 - `"always_allow"`
4205
4206 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4207
4208 Tool calls require user confirmation before execution.
4209
4210 - `type: "always_ask"`
4211
4212 - `"always_ask"`
4213
42146439### Beta Managed Agents Agent Toolset20260401
42156440
42166441- `BetaManagedAgentsAgentToolset20260401 object { configs, default_config, type }`
42176442
42186443 - `configs: array of BetaManagedAgentsAgentToolConfig`
42196444
4220 - `enabled: boolean`
4221
4222 - `name: "bash" or "edit" or "read" or 5 more`
4223
4224 Built-in agent tool identifier.
4225
4226 - `"bash"`
4227
4228 - `"edit"`
4229
4230 - `"read"`
4231
4232 - `"write"`
4233
4234 - `"glob"`
4235
4236 - `"grep"`
4237
4238 - `"web_fetch"`
4239
4240 - `"web_search"`
4241
4242 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
4243
4244 Permission policy for tool execution.
4245
4246 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4247
4248 Tool calls are automatically approved without user confirmation.
4249
4250 - `type: "always_allow"`
4251
4252 - `"always_allow"`
4253
4254 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4255
4256 Tool calls require user confirmation before execution.
4257
4258 - `type: "always_ask"`
4259
4260 - `"always_ask"`
6445 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
6446
6447 Configuration for the bash tool.
6448
6449 - `enabled: boolean`
6450
6451 - `name: "bash"`
6452
6453 - `"bash"`
6454
6455 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
6456
6457 Permission policy for tool execution.
6458
6459 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6460
6461 Tool calls are automatically approved without user confirmation.
6462
6463 - `type: "always_allow"`
6464
6465 - `"always_allow"`
6466
6467 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6468
6469 Tool calls require user confirmation before execution.
6470
6471 - `type: "always_ask"`
6472
6473 - `"always_ask"`
6474
6475 - `type: "bash"`
6476
6477 - `"bash"`
6478
6479 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
6480
6481 Configuration for the edit tool.
6482
6483 - `enabled: boolean`
6484
6485 - `name: "edit"`
6486
6487 - `"edit"`
6488
6489 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
6490
6491 Permission policy for tool execution.
6492
6493 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6494
6495 Tool calls are automatically approved without user confirmation.
6496
6497 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6498
6499 Tool calls require user confirmation before execution.
6500
6501 - `type: "edit"`
6502
6503 - `"edit"`
6504
6505 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
6506
6507 Configuration for the read tool.
6508
6509 - `enabled: boolean`
6510
6511 - `name: "read"`
6512
6513 - `"read"`
6514
6515 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
6516
6517 Permission policy for tool execution.
6518
6519 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6520
6521 Tool calls are automatically approved without user confirmation.
6522
6523 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6524
6525 Tool calls require user confirmation before execution.
6526
6527 - `type: "read"`
6528
6529 - `"read"`
6530
6531 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
6532
6533 Configuration for the write tool.
6534
6535 - `enabled: boolean`
6536
6537 - `name: "write"`
6538
6539 - `"write"`
6540
6541 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
6542
6543 Permission policy for tool execution.
6544
6545 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6546
6547 Tool calls are automatically approved without user confirmation.
6548
6549 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6550
6551 Tool calls require user confirmation before execution.
6552
6553 - `type: "write"`
6554
6555 - `"write"`
6556
6557 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
6558
6559 Configuration for the glob tool.
6560
6561 - `enabled: boolean`
6562
6563 - `name: "glob"`
6564
6565 - `"glob"`
6566
6567 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
6568
6569 Permission policy for tool execution.
6570
6571 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6572
6573 Tool calls are automatically approved without user confirmation.
6574
6575 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6576
6577 Tool calls require user confirmation before execution.
6578
6579 - `type: "glob"`
6580
6581 - `"glob"`
6582
6583 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
6584
6585 Configuration for the grep tool.
6586
6587 - `enabled: boolean`
6588
6589 - `name: "grep"`
6590
6591 - `"grep"`
6592
6593 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
6594
6595 Permission policy for tool execution.
6596
6597 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6598
6599 Tool calls are automatically approved without user confirmation.
6600
6601 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6602
6603 Tool calls require user confirmation before execution.
6604
6605 - `type: "grep"`
6606
6607 - `"grep"`
6608
6609 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
6610
6611 Configuration for the web_fetch tool.
6612
6613 - `enabled: boolean`
6614
6615 - `name: "web_fetch"`
6616
6617 - `"web_fetch"`
6618
6619 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
6620
6621 Permission policy for tool execution.
6622
6623 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6624
6625 Tool calls are automatically approved without user confirmation.
6626
6627 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6628
6629 Tool calls require user confirmation before execution.
6630
6631 - `type: "web_fetch"`
6632
6633 - `"web_fetch"`
6634
6635 - `allowed_domains: optional array of string`
6636
6637 - `blocked_domains: optional array of string`
6638
6639 - `max_content_tokens: optional number or null`
6640
6641 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
6642
6643 Configuration for the web_search tool.
6644
6645 - `enabled: boolean`
6646
6647 - `name: "web_search"`
6648
6649 - `"web_search"`
6650
6651 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
6652
6653 Permission policy for tool execution.
6654
6655 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6656
6657 Tool calls are automatically approved without user confirmation.
6658
6659 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6660
6661 Tool calls require user confirmation before execution.
6662
6663 - `type: "web_search"`
6664
6665 - `"web_search"`
6666
6667 - `allowed_domains: optional array of string`
6668
6669 - `blocked_domains: optional array of string`
6670
6671 - `user_location: optional BetaManagedAgentsUserLocation or null`
6672
6673 Approximate user location for search result localization.
6674
6675 - `type: "approximate"`
6676
6677 Location precision. Only "approximate" is supported.
6678
6679 - `"approximate"`
6680
6681 - `city: optional string or null`
6682
6683 City name.
6684
6685 - `country: optional string or null`
6686
6687 Two-letter ISO 3166-1 country code, uppercase.
6688
6689 - `region: optional string or null`
6690
6691 Region or state name.
6692
6693 - `timezone: optional string or null`
6694
6695 IANA timezone identifier, e.g. "America/Los_Angeles".
42616696
42626697 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
42636698
from line 6813
43786813
43796814 Per-tool configuration overrides.
43806815
4381 - `name: "bash" or "edit" or "read" or 5 more`
4382
4383 Built-in agent tool identifier.
4384
4385 - `"bash"`
4386
4387 - `"edit"`
4388
4389 - `"read"`
4390
4391 - `"write"`
4392
4393 - `"glob"`
4394
4395 - `"grep"`
4396
4397 - `"web_fetch"`
4398
4399 - `"web_search"`
4400
4401 - `enabled: optional boolean or null`
4402
4403 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
4404
4405 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
4406
4407 Permission policy for tool execution.
4408
4409 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
4410
4411 Tool calls are automatically approved without user confirmation.
4412
4413 - `type: "always_allow"`
4414
4415 - `"always_allow"`
4416
4417 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
4418
4419 Tool calls require user confirmation before execution.
4420
4421 - `type: "always_ask"`
4422
4423 - `"always_ask"`
6816 - `BetaManagedAgentsBashToolConfigParams object { name, enabled, permission_policy, type }`
6817
6818 Configuration override for the bash tool.
6819
6820 - `name: "bash"`
6821
6822 Must be "bash".
6823
6824 - `"bash"`
6825
6826 - `enabled: optional boolean or null`
6827
6828 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
6829
6830 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
6831
6832 Permission policy for tool execution.
6833
6834 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6835
6836 Tool calls are automatically approved without user confirmation.
6837
6838 - `type: "always_allow"`
6839
6840 - `"always_allow"`
6841
6842 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6843
6844 Tool calls require user confirmation before execution.
6845
6846 - `type: "always_ask"`
6847
6848 - `"always_ask"`
6849
6850 - `type: optional "bash"`
6851
6852 - `"bash"`
6853
6854 - `BetaManagedAgentsEditToolConfigParams object { name, enabled, permission_policy, type }`
6855
6856 Configuration override for the edit tool.
6857
6858 - `name: "edit"`
6859
6860 Must be "edit".
6861
6862 - `"edit"`
6863
6864 - `enabled: optional boolean or null`
6865
6866 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
6867
6868 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
6869
6870 Permission policy for tool execution.
6871
6872 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6873
6874 Tool calls are automatically approved without user confirmation.
6875
6876 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6877
6878 Tool calls require user confirmation before execution.
6879
6880 - `type: optional "edit"`
6881
6882 - `"edit"`
6883
6884 - `BetaManagedAgentsReadToolConfigParams object { name, enabled, permission_policy, type }`
6885
6886 Configuration override for the read tool.
6887
6888 - `name: "read"`
6889
6890 Must be "read".
6891
6892 - `"read"`
6893
6894 - `enabled: optional boolean or null`
6895
6896 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
6897
6898 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
6899
6900 Permission policy for tool execution.
6901
6902 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6903
6904 Tool calls are automatically approved without user confirmation.
6905
6906 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6907
6908 Tool calls require user confirmation before execution.
6909
6910 - `type: optional "read"`
6911
6912 - `"read"`
6913
6914 - `BetaManagedAgentsWriteToolConfigParams object { name, enabled, permission_policy, type }`
6915
6916 Configuration override for the write tool.
6917
6918 - `name: "write"`
6919
6920 Must be "write".
6921
6922 - `"write"`
6923
6924 - `enabled: optional boolean or null`
6925
6926 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
6927
6928 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
6929
6930 Permission policy for tool execution.
6931
6932 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6933
6934 Tool calls are automatically approved without user confirmation.
6935
6936 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6937
6938 Tool calls require user confirmation before execution.
6939
6940 - `type: optional "write"`
6941
6942 - `"write"`
6943
6944 - `BetaManagedAgentsGlobToolConfigParams object { name, enabled, permission_policy, type }`
6945
6946 Configuration override for the glob tool.
6947
6948 - `name: "glob"`
6949
6950 Must be "glob".
6951
6952 - `"glob"`
6953
6954 - `enabled: optional boolean or null`
6955
6956 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
6957
6958 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
6959
6960 Permission policy for tool execution.
6961
6962 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6963
6964 Tool calls are automatically approved without user confirmation.
6965
6966 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6967
6968 Tool calls require user confirmation before execution.
6969
6970 - `type: optional "glob"`
6971
6972 - `"glob"`
6973
6974 - `BetaManagedAgentsGrepToolConfigParams object { name, enabled, permission_policy, type }`
6975
6976 Configuration override for the grep tool.
6977
6978 - `name: "grep"`
6979
6980 Must be "grep".
6981
6982 - `"grep"`
6983
6984 - `enabled: optional boolean or null`
6985
6986 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
6987
6988 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
6989
6990 Permission policy for tool execution.
6991
6992 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6993
6994 Tool calls are automatically approved without user confirmation.
6995
6996 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6997
6998 Tool calls require user confirmation before execution.
6999
7000 - `type: optional "grep"`
7001
7002 - `"grep"`
7003
7004 - `BetaManagedAgentsWebFetchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
7005
7006 Configuration override for the web_fetch tool.
7007
7008 - `name: "web_fetch"`
7009
7010 Must be "web_fetch".
7011
7012 - `"web_fetch"`
7013
7014 - `allowed_domains: optional array of string`
7015
7016 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.
7017
7018 - `blocked_domains: optional array of string`
7019
7020 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.
7021
7022 - `enabled: optional boolean or null`
7023
7024 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
7025
7026 - `max_content_tokens: optional number or null`
7027
7028 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.
7029
7030 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
7031
7032 Permission policy for tool execution.
7033
7034 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
7035
7036 Tool calls are automatically approved without user confirmation.
7037
7038 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
7039
7040 Tool calls require user confirmation before execution.
7041
7042 - `type: optional "web_fetch"`
7043
7044 - `"web_fetch"`
7045
7046 - `BetaManagedAgentsWebSearchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
7047
7048 Configuration override for the web_search tool.
7049
7050 - `name: "web_search"`
7051
7052 Must be "web_search".
7053
7054 - `"web_search"`
7055
7056 - `allowed_domains: optional array of string`
7057
7058 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.
7059
7060 - `blocked_domains: optional array of string`
7061
7062 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.
7063
7064 - `enabled: optional boolean or null`
7065
7066 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
7067
7068 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
7069
7070 Permission policy for tool execution.
7071
7072 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
7073
7074 Tool calls are automatically approved without user confirmation.
7075
7076 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
7077
7078 Tool calls require user confirmation before execution.
7079
7080 - `type: optional "web_search"`
7081
7082 - `"web_search"`
7083
7084 - `user_location: optional BetaManagedAgentsUserLocation or null`
7085
7086 Approximate user location for search result localization.
7087
7088 - `type: "approximate"`
7089
7090 Location precision. Only "approximate" is supported.
7091
7092 - `"approximate"`
7093
7094 - `city: optional string or null`
7095
7096 City name.
7097
7098 - `country: optional string or null`
7099
7100 Two-letter ISO 3166-1 country code, uppercase.
7101
7102 - `region: optional string or null`
7103
7104 Region or state name.
7105
7106 - `timezone: optional string or null`
7107
7108 IANA timezone identifier, e.g. "America/Los_Angeles".
44247109
44257110 - `default_config: optional BetaManagedAgentsAgentToolsetDefaultConfigParams or null`
44267111
from line 7212
45277212
45287213 Version to pin. Defaults to latest if omitted.
45297214
7215### Beta Managed Agents Bash Tool Config
7216
7217- `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
7218
7219 Configuration for the bash tool.
7220
7221 - `enabled: boolean`
7222
7223 - `name: "bash"`
7224
7225 - `"bash"`
7226
7227 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
7228
7229 Permission policy for tool execution.
7230
7231 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
7232
7233 Tool calls are automatically approved without user confirmation.
7234
7235 - `type: "always_allow"`
7236
7237 - `"always_allow"`
7238
7239 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
7240
7241 Tool calls require user confirmation before execution.
7242
7243 - `type: "always_ask"`
7244
7245 - `"always_ask"`
7246
7247 - `type: "bash"`
7248
7249 - `"bash"`
7250
7251### Beta Managed Agents Bash Tool Config Params
7252
7253- `BetaManagedAgentsBashToolConfigParams object { name, enabled, permission_policy, type }`
7254
7255 Configuration override for the bash tool.
7256
7257 - `name: "bash"`
7258
7259 Must be "bash".
7260
7261 - `"bash"`
7262
7263 - `enabled: optional boolean or null`
7264
7265 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
7266
7267 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
7268
7269 Permission policy for tool execution.
7270
7271 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
7272
7273 Tool calls are automatically approved without user confirmation.
7274
7275 - `type: "always_allow"`
7276
7277 - `"always_allow"`
7278
7279 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
7280
7281 Tool calls require user confirmation before execution.
7282
7283 - `type: "always_ask"`
7284
7285 - `"always_ask"`
7286
7287 - `type: optional "bash"`
7288
7289 - `"bash"`
7290
45307291### Beta Managed Agents Custom Skill
45317292
45327293- `BetaManagedAgentsCustomSkill object { skill_id, type, version }`
from line 7390
46297390
46307391 - `"custom"`
46317392
7393### Beta Managed Agents Edit Tool Config
7394
7395- `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
7396
7397 Configuration for the edit tool.
7398
7399 - `enabled: boolean`
7400
7401 - `name: "edit"`
7402
7403 - `"edit"`
7404
7405 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
7406
7407 Permission policy for tool execution.
7408
7409 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
7410
7411 Tool calls are automatically approved without user confirmation.
7412
7413 - `type: "always_allow"`
7414
7415 - `"always_allow"`
7416
7417 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
7418
7419 Tool calls require user confirmation before execution.
7420
7421 - `type: "always_ask"`
7422
7423 - `"always_ask"`
7424
7425 - `type: "edit"`
7426
7427 - `"edit"`
7428
7429### Beta Managed Agents Edit Tool Config Params
7430
7431- `BetaManagedAgentsEditToolConfigParams object { name, enabled, permission_policy, type }`
7432
7433 Configuration override for the edit tool.
7434
7435 - `name: "edit"`
7436
7437 Must be "edit".
7438
7439 - `"edit"`
7440
7441 - `enabled: optional boolean or null`
7442
7443 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
7444
7445 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
7446
7447 Permission policy for tool execution.
7448
7449 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
7450
7451 Tool calls are automatically approved without user confirmation.
7452
7453 - `type: "always_allow"`
7454
7455 - `"always_allow"`
7456
7457 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
7458
7459 Tool calls require user confirmation before execution.
7460
7461 - `type: "always_ask"`
7462
7463 - `"always_ask"`
7464
7465 - `type: optional "edit"`
7466
7467 - `"edit"`
7468
46327469### Beta Managed Agents Effort High
46337470
46347471- `BetaManagedAgentsEffortHigh object { type }`
from line 7516
46797516
46807517 - `"xhigh"`
46817518
7519### Beta Managed Agents Glob Tool Config
7520
7521- `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
7522
7523 Configuration for the glob tool.
7524
7525 - `enabled: boolean`
7526
7527 - `name: "glob"`
7528
7529 - `"glob"`
7530
7531 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
7532
7533 Permission policy for tool execution.
7534
7535 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
7536
7537 Tool calls are automatically approved without user confirmation.
7538
7539 - `type: "always_allow"`
7540
7541 - `"always_allow"`
7542
7543 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
7544
7545 Tool calls require user confirmation before execution.
7546
7547 - `type: "always_ask"`
7548
7549 - `"always_ask"`
7550
7551 - `type: "glob"`
7552
7553 - `"glob"`
7554
7555### Beta Managed Agents Glob Tool Config Params
7556
7557- `BetaManagedAgentsGlobToolConfigParams object { name, enabled, permission_policy, type }`
7558
7559 Configuration override for the glob tool.
7560
7561 - `name: "glob"`
7562
7563 Must be "glob".
7564
7565 - `"glob"`
7566
7567 - `enabled: optional boolean or null`
7568
7569 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
7570
7571 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
7572
7573 Permission policy for tool execution.
7574
7575 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
7576
7577 Tool calls are automatically approved without user confirmation.
7578
7579 - `type: "always_allow"`
7580
7581 - `"always_allow"`
7582
7583 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
7584
7585 Tool calls require user confirmation before execution.
7586
7587 - `type: "always_ask"`
7588
7589 - `"always_ask"`
7590
7591 - `type: optional "glob"`
7592
7593 - `"glob"`
7594
7595### Beta Managed Agents Grep Tool Config
7596
7597- `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
7598
7599 Configuration for the grep tool.
7600
7601 - `enabled: boolean`
7602
7603 - `name: "grep"`
7604
7605 - `"grep"`
7606
7607 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
7608
7609 Permission policy for tool execution.
7610
7611 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
7612
7613 Tool calls are automatically approved without user confirmation.
7614
7615 - `type: "always_allow"`
7616
7617 - `"always_allow"`
7618
7619 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
7620
7621 Tool calls require user confirmation before execution.
7622
7623 - `type: "always_ask"`
7624
7625 - `"always_ask"`
7626
7627 - `type: "grep"`
7628
7629 - `"grep"`
7630
7631### Beta Managed Agents Grep Tool Config Params
7632
7633- `BetaManagedAgentsGrepToolConfigParams object { name, enabled, permission_policy, type }`
7634
7635 Configuration override for the grep tool.
7636
7637 - `name: "grep"`
7638
7639 Must be "grep".
7640
7641 - `"grep"`
7642
7643 - `enabled: optional boolean or null`
7644
7645 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
7646
7647 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
7648
7649 Permission policy for tool execution.
7650
7651 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
7652
7653 Tool calls are automatically approved without user confirmation.
7654
7655 - `type: "always_allow"`
7656
7657 - `"always_allow"`
7658
7659 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
7660
7661 Tool calls require user confirmation before execution.
7662
7663 - `type: "always_ask"`
7664
7665 - `"always_ask"`
7666
7667 - `type: optional "grep"`
7668
7669 - `"grep"`
7670
46827671### Beta Managed Agents MCP Server URL Definition
46837672
46847673- `BetaManagedAgentsMCPServerURLDefinition object { name, type, url }`
from line 8362
53738362
53748363 - `"self"`
53758364
8365### Beta Managed Agents Read Tool Config
8366
8367- `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
8368
8369 Configuration for the read tool.
8370
8371 - `enabled: boolean`
8372
8373 - `name: "read"`
8374
8375 - `"read"`
8376
8377 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
8378
8379 Permission policy for tool execution.
8380
8381 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
8382
8383 Tool calls are automatically approved without user confirmation.
8384
8385 - `type: "always_allow"`
8386
8387 - `"always_allow"`
8388
8389 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
8390
8391 Tool calls require user confirmation before execution.
8392
8393 - `type: "always_ask"`
8394
8395 - `"always_ask"`
8396
8397 - `type: "read"`
8398
8399 - `"read"`
8400
8401### Beta Managed Agents Read Tool Config Params
8402
8403- `BetaManagedAgentsReadToolConfigParams object { name, enabled, permission_policy, type }`
8404
8405 Configuration override for the read tool.
8406
8407 - `name: "read"`
8408
8409 Must be "read".
8410
8411 - `"read"`
8412
8413 - `enabled: optional boolean or null`
8414
8415 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
8416
8417 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
8418
8419 Permission policy for tool execution.
8420
8421 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
8422
8423 Tool calls are automatically approved without user confirmation.
8424
8425 - `type: "always_allow"`
8426
8427 - `"always_allow"`
8428
8429 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
8430
8431 Tool calls require user confirmation before execution.
8432
8433 - `type: "always_ask"`
8434
8435 - `"always_ask"`
8436
8437 - `type: optional "read"`
8438
8439 - `"read"`
8440
53768441### Beta Managed Agents Session Thread Agent
53778442
53788443- `BetaManagedAgentsSessionThreadAgent object { id, description, mcp_servers, 7 more }`
from line 8620
55558620
55568621 - `configs: array of BetaManagedAgentsAgentToolConfig`
55578622
8623 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
8624
8625 Configuration for the bash tool.
8626
8627 - `enabled: boolean`
8628
8629 - `name: "bash"`
8630
8631 - `"bash"`
8632
8633 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
8634
8635 Permission policy for tool execution.
8636
8637 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
8638
8639 Tool calls are automatically approved without user confirmation.
8640
8641 - `type: "always_allow"`
8642
8643 - `"always_allow"`
8644
8645 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
8646
8647 Tool calls require user confirmation before execution.
8648
8649 - `type: "always_ask"`
8650
8651 - `"always_ask"`
8652
8653 - `type: "bash"`
8654
8655 - `"bash"`
8656
8657 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
8658
8659 Configuration for the edit tool.
8660
8661 - `enabled: boolean`
8662
8663 - `name: "edit"`
8664
8665 - `"edit"`
8666
8667 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
8668
8669 Permission policy for tool execution.
8670
8671 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
8672
8673 Tool calls are automatically approved without user confirmation.
8674
8675 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
8676
8677 Tool calls require user confirmation before execution.
8678
8679 - `type: "edit"`
8680
8681 - `"edit"`
8682
8683 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
8684
8685 Configuration for the read tool.
8686
8687 - `enabled: boolean`
8688
8689 - `name: "read"`
8690
8691 - `"read"`
8692
8693 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
8694
8695 Permission policy for tool execution.
8696
8697 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
8698
8699 Tool calls are automatically approved without user confirmation.
8700
8701 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
8702
8703 Tool calls require user confirmation before execution.
8704
8705 - `type: "read"`
8706
8707 - `"read"`
8708
8709 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
8710
8711 Configuration for the write tool.
8712
8713 - `enabled: boolean`
8714
8715 - `name: "write"`
8716
8717 - `"write"`
8718
8719 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
8720
8721 Permission policy for tool execution.
8722
8723 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
8724
8725 Tool calls are automatically approved without user confirmation.
8726
8727 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
8728
8729 Tool calls require user confirmation before execution.
8730
8731 - `type: "write"`
8732
8733 - `"write"`
8734
8735 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
8736
8737 Configuration for the glob tool.
8738
8739 - `enabled: boolean`
8740
8741 - `name: "glob"`
8742
8743 - `"glob"`
8744
8745 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
8746
8747 Permission policy for tool execution.
8748
8749 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
8750
8751 Tool calls are automatically approved without user confirmation.
8752
8753 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
8754
8755 Tool calls require user confirmation before execution.
8756
8757 - `type: "glob"`
8758
8759 - `"glob"`
8760
8761 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
8762
8763 Configuration for the grep tool.
8764
8765 - `enabled: boolean`
8766
8767 - `name: "grep"`
8768
8769 - `"grep"`
8770
8771 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
8772
8773 Permission policy for tool execution.
8774
8775 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
8776
8777 Tool calls are automatically approved without user confirmation.
8778
8779 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
8780
8781 Tool calls require user confirmation before execution.
8782
8783 - `type: "grep"`
8784
8785 - `"grep"`
8786
8787 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
8788
8789 Configuration for the web_fetch tool.
8790
8791 - `enabled: boolean`
8792
8793 - `name: "web_fetch"`
8794
8795 - `"web_fetch"`
8796
8797 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
8798
8799 Permission policy for tool execution.
8800
8801 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
8802
8803 Tool calls are automatically approved without user confirmation.
8804
8805 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
8806
8807 Tool calls require user confirmation before execution.
8808
8809 - `type: "web_fetch"`
8810
8811 - `"web_fetch"`
8812
8813 - `allowed_domains: optional array of string`
8814
8815 - `blocked_domains: optional array of string`
8816
8817 - `max_content_tokens: optional number or null`
8818
8819 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
8820
8821 Configuration for the web_search tool.
8822
8823 - `enabled: boolean`
8824
8825 - `name: "web_search"`
8826
8827 - `"web_search"`
8828
8829 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
8830
8831 Permission policy for tool execution.
8832
8833 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
8834
8835 Tool calls are automatically approved without user confirmation.
8836
8837 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
8838
8839 Tool calls require user confirmation before execution.
8840
8841 - `type: "web_search"`
8842
8843 - `"web_search"`
8844
8845 - `allowed_domains: optional array of string`
8846
8847 - `blocked_domains: optional array of string`
8848
8849 - `user_location: optional BetaManagedAgentsUserLocation or null`
8850
8851 Approximate user location for search result localization.
8852
8853 - `type: "approximate"`
8854
8855 Location precision. Only "approximate" is supported.
8856
8857 - `"approximate"`
8858
8859 - `city: optional string or null`
8860
8861 City name.
8862
8863 - `country: optional string or null`
8864
8865 Two-letter ISO 3166-1 country code, uppercase.
8866
8867 - `region: optional string or null`
8868
8869 Region or state name.
8870
8871 - `timezone: optional string or null`
8872
8873 IANA timezone identifier, e.g. "America/Los_Angeles".
8874
8875 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
8876
8877 Resolved default configuration for agent tools.
8878
55588879 - `enabled: boolean`
55598880
5560 - `name: "bash" or "edit" or "read" or 5 more`
5561
5562 Built-in agent tool identifier.
5563
5564 - `"bash"`
5565
5566 - `"edit"`
5567
5568 - `"read"`
5569
5570 - `"write"`
5571
5572 - `"glob"`
5573
5574 - `"grep"`
5575
5576 - `"web_fetch"`
5577
5578 - `"web_search"`
5579
55808881 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
55818882
55828883 Permission policy for tool execution.
from line 8886
55858886
55868887 Tool calls are automatically approved without user confirmation.
55878888
5588 - `type: "always_allow"`
5589
5590 - `"always_allow"`
5591
55928889 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
55938890
55948891 Tool calls require user confirmation before execution.
55958892
5596 - `type: "always_ask"`
5597
5598 - `"always_ask"`
5599
5600 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
5601
5602 Resolved default configuration for agent tools.
8893 - `type: "agent_toolset_20260401"`
8894
8895 - `"agent_toolset_20260401"`
8896
8897 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`
8898
8899 - `configs: array of BetaManagedAgentsMCPToolConfig`
56038900
56048901 - `enabled: boolean`
56058902
8903 - `name: string`
8904
56068905 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
56078906
56088907 Permission policy for tool execution.
from line 8914
56158914
56168915 Tool calls require user confirmation before execution.
56178916
5618 - `type: "agent_toolset_20260401"`
5619
5620 - `"agent_toolset_20260401"`
5621
5622 - `BetaManagedAgentsMCPToolset object { configs, default_config, mcp_server_name, type }`
5623
5624 - `configs: array of BetaManagedAgentsMCPToolConfig`
8917 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
8918
8919 Resolved default configuration for all tools from an MCP server.
56258920
56268921 - `enabled: boolean`
56278922
5628 - `name: string`
5629
56308923 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
56318924
56328925 Permission policy for tool execution.
from line 8932
56398932
56408933 Tool calls require user confirmation before execution.
56418934
5642 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
5643
5644 Resolved default configuration for all tools from an MCP server.
5645
5646 - `enabled: boolean`
5647
5648 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
5649
5650 Permission policy for tool execution.
5651
5652 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
5653
5654 Tool calls are automatically approved without user confirmation.
5655
5656 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
5657
5658 Tool calls require user confirmation before execution.
5659
56608935 - `mcp_server_name: string`
56618936
56628937 - `type: "mcp_toolset"`
from line 9024
57499024
57509025 Endpoint URL for the MCP server.
57519026
9027### Beta Managed Agents User Location
9028
9029- `BetaManagedAgentsUserLocation object { type, city, country, 2 more }`
9030
9031 Approximate user location for search result localization.
9032
9033 - `type: "approximate"`
9034
9035 Location precision. Only "approximate" is supported.
9036
9037 - `"approximate"`
9038
9039 - `city: optional string or null`
9040
9041 City name.
9042
9043 - `country: optional string or null`
9044
9045 Two-letter ISO 3166-1 country code, uppercase.
9046
9047 - `region: optional string or null`
9048
9049 Region or state name.
9050
9051 - `timezone: optional string or null`
9052
9053 IANA timezone identifier, e.g. "America/Los_Angeles".
9054
9055### Beta Managed Agents Web Fetch Tool Config
9056
9057- `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
9058
9059 Configuration for the web_fetch tool.
9060
9061 - `enabled: boolean`
9062
9063 - `name: "web_fetch"`
9064
9065 - `"web_fetch"`
9066
9067 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
9068
9069 Permission policy for tool execution.
9070
9071 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
9072
9073 Tool calls are automatically approved without user confirmation.
9074
9075 - `type: "always_allow"`
9076
9077 - `"always_allow"`
9078
9079 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
9080
9081 Tool calls require user confirmation before execution.
9082
9083 - `type: "always_ask"`
9084
9085 - `"always_ask"`
9086
9087 - `type: "web_fetch"`
9088
9089 - `"web_fetch"`
9090
9091 - `allowed_domains: optional array of string`
9092
9093 - `blocked_domains: optional array of string`
9094
9095 - `max_content_tokens: optional number or null`
9096
9097### Beta Managed Agents Web Fetch Tool Config Params
9098
9099- `BetaManagedAgentsWebFetchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
9100
9101 Configuration override for the web_fetch tool.
9102
9103 - `name: "web_fetch"`
9104
9105 Must be "web_fetch".
9106
9107 - `"web_fetch"`
9108
9109 - `allowed_domains: optional array of string`
9110
9111 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.
9112
9113 - `blocked_domains: optional array of string`
9114
9115 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.
9116
9117 - `enabled: optional boolean or null`
9118
9119 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
9120
9121 - `max_content_tokens: optional number or null`
9122
9123 Maximum number of tokens of fetched text content to include in context per call. Does not apply to binary content such as PDFs.
9124
9125 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
9126
9127 Permission policy for tool execution.
9128
9129 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
9130
9131 Tool calls are automatically approved without user confirmation.
9132
9133 - `type: "always_allow"`
9134
9135 - `"always_allow"`
9136
9137 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
9138
9139 Tool calls require user confirmation before execution.
9140
9141 - `type: "always_ask"`
9142
9143 - `"always_ask"`
9144
9145 - `type: optional "web_fetch"`
9146
9147 - `"web_fetch"`
9148
9149### Beta Managed Agents Web Search Tool Config
9150
9151- `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
9152
9153 Configuration for the web_search tool.
9154
9155 - `enabled: boolean`
9156
9157 - `name: "web_search"`
9158
9159 - `"web_search"`
9160
9161 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
9162
9163 Permission policy for tool execution.
9164
9165 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
9166
9167 Tool calls are automatically approved without user confirmation.
9168
9169 - `type: "always_allow"`
9170
9171 - `"always_allow"`
9172
9173 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
9174
9175 Tool calls require user confirmation before execution.
9176
9177 - `type: "always_ask"`
9178
9179 - `"always_ask"`
9180
9181 - `type: "web_search"`
9182
9183 - `"web_search"`
9184
9185 - `allowed_domains: optional array of string`
9186
9187 - `blocked_domains: optional array of string`
9188
9189 - `user_location: optional BetaManagedAgentsUserLocation or null`
9190
9191 Approximate user location for search result localization.
9192
9193 - `type: "approximate"`
9194
9195 Location precision. Only "approximate" is supported.
9196
9197 - `"approximate"`
9198
9199 - `city: optional string or null`
9200
9201 City name.
9202
9203 - `country: optional string or null`
9204
9205 Two-letter ISO 3166-1 country code, uppercase.
9206
9207 - `region: optional string or null`
9208
9209 Region or state name.
9210
9211 - `timezone: optional string or null`
9212
9213 IANA timezone identifier, e.g. "America/Los_Angeles".
9214
9215### Beta Managed Agents Web Search Tool Config Params
9216
9217- `BetaManagedAgentsWebSearchToolConfigParams object { name, allowed_domains, blocked_domains, 4 more }`
9218
9219 Configuration override for the web_search tool.
9220
9221 - `name: "web_search"`
9222
9223 Must be "web_search".
9224
9225 - `"web_search"`
9226
9227 - `allowed_domains: optional array of string`
9228
9229 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.
9230
9231 - `blocked_domains: optional array of string`
9232
9233 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.
9234
9235 - `enabled: optional boolean or null`
9236
9237 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
9238
9239 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
9240
9241 Permission policy for tool execution.
9242
9243 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
9244
9245 Tool calls are automatically approved without user confirmation.
9246
9247 - `type: "always_allow"`
9248
9249 - `"always_allow"`
9250
9251 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
9252
9253 Tool calls require user confirmation before execution.
9254
9255 - `type: "always_ask"`
9256
9257 - `"always_ask"`
9258
9259 - `type: optional "web_search"`
9260
9261 - `"web_search"`
9262
9263 - `user_location: optional BetaManagedAgentsUserLocation or null`
9264
9265 Approximate user location for search result localization.
9266
9267 - `type: "approximate"`
9268
9269 Location precision. Only "approximate" is supported.
9270
9271 - `"approximate"`
9272
9273 - `city: optional string or null`
9274
9275 City name.
9276
9277 - `country: optional string or null`
9278
9279 Two-letter ISO 3166-1 country code, uppercase.
9280
9281 - `region: optional string or null`
9282
9283 Region or state name.
9284
9285 - `timezone: optional string or null`
9286
9287 IANA timezone identifier, e.g. "America/Los_Angeles".
9288
9289### Beta Managed Agents Write Tool Config
9290
9291- `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
9292
9293 Configuration for the write tool.
9294
9295 - `enabled: boolean`
9296
9297 - `name: "write"`
9298
9299 - `"write"`
9300
9301 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
9302
9303 Permission policy for tool execution.
9304
9305 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
9306
9307 Tool calls are automatically approved without user confirmation.
9308
9309 - `type: "always_allow"`
9310
9311 - `"always_allow"`
9312
9313 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
9314
9315 Tool calls require user confirmation before execution.
9316
9317 - `type: "always_ask"`
9318
9319 - `"always_ask"`
9320
9321 - `type: "write"`
9322
9323 - `"write"`
9324
9325### Beta Managed Agents Write Tool Config Params
9326
9327- `BetaManagedAgentsWriteToolConfigParams object { name, enabled, permission_policy, type }`
9328
9329 Configuration override for the write tool.
9330
9331 - `name: "write"`
9332
9333 Must be "write".
9334
9335 - `"write"`
9336
9337 - `enabled: optional boolean or null`
9338
9339 Whether this tool is enabled and available to Claude. Overrides the default_config setting.
9340
9341 - `permission_policy: optional BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or null`
9342
9343 Permission policy for tool execution.
9344
9345 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
9346
9347 Tool calls are automatically approved without user confirmation.
9348
9349 - `type: "always_allow"`
9350
9351 - `"always_allow"`
9352
9353 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
9354
9355 Tool calls require user confirmation before execution.
9356
9357 - `type: "always_ask"`
9358
9359 - `"always_ask"`
9360
9361 - `type: optional "write"`
9362
9363 - `"write"`
9364
57529365# Versions
57539366
57549367## List Agent Versions
from line 9690
60779690
60789691 - `configs: array of BetaManagedAgentsAgentToolConfig`
60799692
6080 - `enabled: boolean`
6081
6082 - `name: "bash" or "edit" or "read" or 5 more`
6083
6084 Built-in agent tool identifier.
6085
6086 - `"bash"`
6087
6088 - `"edit"`
6089
6090 - `"read"`
6091
6092 - `"write"`
6093
6094 - `"glob"`
6095
6096 - `"grep"`
6097
6098 - `"web_fetch"`
6099
6100 - `"web_search"`
6101
6102 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
6103
6104 Permission policy for tool execution.
6105
6106 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
6107
6108 Tool calls are automatically approved without user confirmation.
6109
6110 - `type: "always_allow"`
6111
6112 - `"always_allow"`
6113
6114 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
6115
6116 Tool calls require user confirmation before execution.
6117
6118 - `type: "always_ask"`
6119
6120 - `"always_ask"`
9693 - `BetaManagedAgentsBashToolConfig object { enabled, name, permission_policy, type }`
9694
9695 Configuration for the bash tool.
9696
9697 - `enabled: boolean`
9698
9699 - `name: "bash"`
9700
9701 - `"bash"`
9702
9703 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
9704
9705 Permission policy for tool execution.
9706
9707 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
9708
9709 Tool calls are automatically approved without user confirmation.
9710
9711 - `type: "always_allow"`
9712
9713 - `"always_allow"`
9714
9715 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
9716
9717 Tool calls require user confirmation before execution.
9718
9719 - `type: "always_ask"`
9720
9721 - `"always_ask"`
9722
9723 - `type: "bash"`
9724
9725 - `"bash"`
9726
9727 - `BetaManagedAgentsEditToolConfig object { enabled, name, permission_policy, type }`
9728
9729 Configuration for the edit tool.
9730
9731 - `enabled: boolean`
9732
9733 - `name: "edit"`
9734
9735 - `"edit"`
9736
9737 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
9738
9739 Permission policy for tool execution.
9740
9741 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
9742
9743 Tool calls are automatically approved without user confirmation.
9744
9745 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
9746
9747 Tool calls require user confirmation before execution.
9748
9749 - `type: "edit"`
9750
9751 - `"edit"`
9752
9753 - `BetaManagedAgentsReadToolConfig object { enabled, name, permission_policy, type }`
9754
9755 Configuration for the read tool.
9756
9757 - `enabled: boolean`
9758
9759 - `name: "read"`
9760
9761 - `"read"`
9762
9763 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
9764
9765 Permission policy for tool execution.
9766
9767 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
9768
9769 Tool calls are automatically approved without user confirmation.
9770
9771 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
9772
9773 Tool calls require user confirmation before execution.
9774
9775 - `type: "read"`
9776
9777 - `"read"`
9778
9779 - `BetaManagedAgentsWriteToolConfig object { enabled, name, permission_policy, type }`
9780
9781 Configuration for the write tool.
9782
9783 - `enabled: boolean`
9784
9785 - `name: "write"`
9786
9787 - `"write"`
9788
9789 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
9790
9791 Permission policy for tool execution.
9792
9793 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
9794
9795 Tool calls are automatically approved without user confirmation.
9796
9797 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
9798
9799 Tool calls require user confirmation before execution.
9800
9801 - `type: "write"`
9802
9803 - `"write"`
9804
9805 - `BetaManagedAgentsGlobToolConfig object { enabled, name, permission_policy, type }`
9806
9807 Configuration for the glob tool.
9808
9809 - `enabled: boolean`
9810
9811 - `name: "glob"`
9812
9813 - `"glob"`
9814
9815 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
9816
9817 Permission policy for tool execution.
9818
9819 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
9820
9821 Tool calls are automatically approved without user confirmation.
9822
9823 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
9824
9825 Tool calls require user confirmation before execution.
9826
9827 - `type: "glob"`
9828
9829 - `"glob"`
9830
9831 - `BetaManagedAgentsGrepToolConfig object { enabled, name, permission_policy, type }`
9832
9833 Configuration for the grep tool.
9834
9835 - `enabled: boolean`
9836
9837 - `name: "grep"`
9838
9839 - `"grep"`
9840
9841 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
9842
9843 Permission policy for tool execution.
9844
9845 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
9846
9847 Tool calls are automatically approved without user confirmation.
9848
9849 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
9850
9851 Tool calls require user confirmation before execution.
9852
9853 - `type: "grep"`
9854
9855 - `"grep"`
9856
9857 - `BetaManagedAgentsWebFetchToolConfig object { enabled, name, permission_policy, 4 more }`
9858
9859 Configuration for the web_fetch tool.
9860
9861 - `enabled: boolean`
9862
9863 - `name: "web_fetch"`
9864
9865 - `"web_fetch"`
9866
9867 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
9868
9869 Permission policy for tool execution.
9870
9871 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
9872
9873 Tool calls are automatically approved without user confirmation.
9874
9875 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
9876
9877 Tool calls require user confirmation before execution.
9878
9879 - `type: "web_fetch"`
9880
9881 - `"web_fetch"`
9882
9883 - `allowed_domains: optional array of string`
9884
9885 - `blocked_domains: optional array of string`
9886
9887 - `max_content_tokens: optional number or null`
9888
9889 - `BetaManagedAgentsWebSearchToolConfig object { enabled, name, permission_policy, 4 more }`
9890
9891 Configuration for the web_search tool.
9892
9893 - `enabled: boolean`
9894
9895 - `name: "web_search"`
9896
9897 - `"web_search"`
9898
9899 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy`
9900
9901 Permission policy for tool execution.
9902
9903 - `BetaManagedAgentsAlwaysAllowPolicy object { type }`
9904
9905 Tool calls are automatically approved without user confirmation.
9906
9907 - `BetaManagedAgentsAlwaysAskPolicy object { type }`
9908
9909 Tool calls require user confirmation before execution.
9910
9911 - `type: "web_search"`
9912
9913 - `"web_search"`
9914
9915 - `allowed_domains: optional array of string`
9916
9917 - `blocked_domains: optional array of string`
9918
9919 - `user_location: optional BetaManagedAgentsUserLocation or null`
9920
9921 Approximate user location for search result localization.
9922
9923 - `type: "approximate"`
9924
9925 Location precision. Only "approximate" is supported.
9926
9927 - `"approximate"`
9928
9929 - `city: optional string or null`
9930
9931 City name.
9932
9933 - `country: optional string or null`
9934
9935 Two-letter ISO 3166-1 country code, uppercase.
9936
9937 - `region: optional string or null`
9938
9939 Region or state name.
9940
9941 - `timezone: optional string or null`
9942
9943 IANA timezone identifier, e.g. "America/Los_Angeles".
61219944
61229945 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
61239946
from line 10117
629410117 "name": "bash",
629510118 "permission_policy": {
629610119 "type": "always_allow"
6297 }
10120 },
10121 "type": "bash"
629810122 }
629910123 ],
630010124 "default_config": {
630110125
No line in this hunk matches that.