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