Update Session changedapi/beta/sessions/update
Nearest release: v2.1.296, published 4 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+571added
Lines−437removed
From line
795
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits18to this page, all time
The whole hunk
from line 795, 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 795
795795
796796 - `"claude-haiku-4-5"`
797797
798 Fastest model with near-frontier intelligence
799
800798 - `"claude-haiku-4-5-20251001"`
801799
802 Fastest model with near-frontier intelligence
803
804800 - `"claude-opus-4-5"`
805801
806802 Powerful intelligence for long-running agents and coding
from line 865
869865
870866 - `"fast"`
871867
872 - `multiagent: BetaManagedAgentsSessionMultiagentCoordinator or null`
868 - `multiagent: BetaManagedAgentsSessionMultiagent or null`
873869
874870 Resolved multiagent orchestration configuration. Null when the agent is single-threaded.
875871
876 - `type: "coordinator"`
877
878 - `agents: array of BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
879
880 Full `agent` definitions the coordinator may spawn as session threads.
881
882 - `BetaManagedAgentsSessionThreadAgent object`
883
884 Resolved `agent` definition for a single `session_thread`. Snapshot of the agent at thread creation time. The multiagent roster is not repeated here; read it from `Session.agent`.
885
886 - `type: "agent"`
887
888 - `id: string`
889
890 - `description: string or null`
891
892 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
893
894 - `type: "url"`
872 - `BetaManagedAgentsSessionMultiagentCoordinator object`
873
874 Resolved coordinator topology with full agent definitions for each roster member.
875
876 - `type: "coordinator"`
877
878 - `agents: array of BetaManagedAgentsSessionThreadAgent or BetaManagedAgentsAdvisor`
879
880 Full `agent` definitions the coordinator may spawn as session threads.
881
882 - `BetaManagedAgentsSessionThreadAgent object`
883
884 Resolved `agent` definition for a single `session_thread`. Snapshot of the agent at thread creation time. The multiagent roster is not repeated here; read it from `Session.agent`.
885
886 - `type: "agent"`
887
888 - `id: string`
889
890 - `description: string or null`
891
892 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
893
894 - `type: "url"`
895
896 - `name: string`
897
898 - `url: string`
899
900 - `model: BetaManagedAgentsModelConfig`
901
902 Model identifier and configuration.
895903
896904 - `name: string`
897905
898 - `url: string`
899
900 - `model: BetaManagedAgentsModelConfig`
901
902 Model identifier and configuration.
903
904 - `name: string`
905
906 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
907
908 - `BetaManagedAgentsAnthropicSkill object`
909
910 A resolved Anthropic-managed skill.
911
912 - `type: "anthropic"`
913
914 - `skill_id: string`
915
916 - `version: string`
917
918 - `BetaManagedAgentsCustomSkill object`
919
920 A resolved user-created custom skill.
921
922 - `type: "custom"`
923
924 - `skill_id: string`
925
926 - `version: string`
927
928 - `system: string or null`
929
930 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
931
932 - `BetaManagedAgentsAgentToolset20260401 object`
933
934 - `type: "agent_toolset_20260401"`
935
936 - `configs: array of BetaManagedAgentsAgentToolConfig`
937
938 - `BetaManagedAgentsBashToolConfig object`
939
940 Configuration for the bash tool.
941
942 - `type: "bash"`
906 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
907
908 - `BetaManagedAgentsAnthropicSkill object`
909
910 A resolved Anthropic-managed skill.
911
912 - `type: "anthropic"`
913
914 - `skill_id: string`
915
916 - `version: string`
917
918 - `BetaManagedAgentsCustomSkill object`
919
920 A resolved user-created custom skill.
921
922 - `type: "custom"`
923
924 - `skill_id: string`
925
926 - `version: string`
927
928 - `system: string or null`
929
930 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
931
932 - `BetaManagedAgentsAgentToolset20260401 object`
933
934 - `type: "agent_toolset_20260401"`
935
936 - `configs: array of BetaManagedAgentsAgentToolConfig`
937
938 - `BetaManagedAgentsBashToolConfig object`
939
940 Configuration for the bash tool.
941
942 - `type: "bash"`
943
944 - `enabled: boolean`
945
946 - `name: "bash"`
947
948 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
949
950 Permission policy for tool execution.
951
952 - `BetaManagedAgentsAlwaysAllowPolicy object`
953
954 Tool calls are automatically approved without user confirmation.
955
956 - `type: "always_allow"`
957
958 - `BetaManagedAgentsAlwaysAskPolicy object`
959
960 Tool calls require user confirmation before execution.
961
962 - `type: "always_ask"`
963
964 - `BetaManagedAgentsAutoPolicy object`
965
966 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
967
968 - `type: "auto"`
969
970 - `BetaManagedAgentsEditToolConfig object`
971
972 Configuration for the edit tool.
973
974 - `type: "edit"`
975
976 - `enabled: boolean`
977
978 - `name: "edit"`
979
980 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
981
982 Permission policy for tool execution.
983
984 - `BetaManagedAgentsAlwaysAllowPolicy object`
985
986 Tool calls are automatically approved without user confirmation.
987
988 - `BetaManagedAgentsAlwaysAskPolicy object`
989
990 Tool calls require user confirmation before execution.
991
992 - `BetaManagedAgentsAutoPolicy object`
993
994 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
995
996 - `BetaManagedAgentsReadToolConfig object`
997
998 Configuration for the read tool.
999
1000 - `type: "read"`
1001
1002 - `enabled: boolean`
1003
1004 - `name: "read"`
1005
1006 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1007
1008 Permission policy for tool execution.
1009
1010 - `BetaManagedAgentsAlwaysAllowPolicy object`
1011
1012 Tool calls are automatically approved without user confirmation.
1013
1014 - `BetaManagedAgentsAlwaysAskPolicy object`
1015
1016 Tool calls require user confirmation before execution.
1017
1018 - `BetaManagedAgentsAutoPolicy object`
1019
1020 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1021
1022 - `BetaManagedAgentsWriteToolConfig object`
1023
1024 Configuration for the write tool.
1025
1026 - `type: "write"`
1027
1028 - `enabled: boolean`
1029
1030 - `name: "write"`
1031
1032 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1033
1034 Permission policy for tool execution.
1035
1036 - `BetaManagedAgentsAlwaysAllowPolicy object`
1037
1038 Tool calls are automatically approved without user confirmation.
1039
1040 - `BetaManagedAgentsAlwaysAskPolicy object`
1041
1042 Tool calls require user confirmation before execution.
1043
1044 - `BetaManagedAgentsAutoPolicy object`
1045
1046 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1047
1048 - `BetaManagedAgentsGlobToolConfig object`
1049
1050 Configuration for the glob tool.
1051
1052 - `type: "glob"`
1053
1054 - `enabled: boolean`
1055
1056 - `name: "glob"`
1057
1058 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1059
1060 Permission policy for tool execution.
1061
1062 - `BetaManagedAgentsAlwaysAllowPolicy object`
1063
1064 Tool calls are automatically approved without user confirmation.
1065
1066 - `BetaManagedAgentsAlwaysAskPolicy object`
1067
1068 Tool calls require user confirmation before execution.
1069
1070 - `BetaManagedAgentsAutoPolicy object`
1071
1072 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1073
1074 - `BetaManagedAgentsGrepToolConfig object`
1075
1076 Configuration for the grep tool.
1077
1078 - `type: "grep"`
1079
1080 - `enabled: boolean`
1081
1082 - `name: "grep"`
1083
1084 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1085
1086 Permission policy for tool execution.
1087
1088 - `BetaManagedAgentsAlwaysAllowPolicy object`
1089
1090 Tool calls are automatically approved without user confirmation.
1091
1092 - `BetaManagedAgentsAlwaysAskPolicy object`
1093
1094 Tool calls require user confirmation before execution.
1095
1096 - `BetaManagedAgentsAutoPolicy object`
1097
1098 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1099
1100 - `BetaManagedAgentsWebFetchToolConfig object`
1101
1102 Configuration for the web_fetch tool.
1103
1104 - `type: "web_fetch"`
1105
1106 - `enabled: boolean`
1107
1108 - `name: "web_fetch"`
1109
1110 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1111
1112 Permission policy for tool execution.
1113
1114 - `BetaManagedAgentsAlwaysAllowPolicy object`
1115
1116 Tool calls are automatically approved without user confirmation.
1117
1118 - `BetaManagedAgentsAlwaysAskPolicy object`
1119
1120 Tool calls require user confirmation before execution.
1121
1122 - `BetaManagedAgentsAutoPolicy object`
1123
1124 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1125
1126 - `url_sources: BetaManagedAgentsWebFetchURLSources or null`
1127
1128 Which sources contribute URLs the tool may fetch, always in the object form. Null when not set, which allows every source.
1129
1130 - `client_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
1131
1132 Which custom tools' results contribute URLs that may be fetched. Null when not set, which allows every custom tool's results.
1133
1134 - `BetaManagedAgentsWebFetchURLSourceAll object`
1135
1136 Every URL from this source may be fetched. This is the default.
1137
1138 - `type: "all"`
1139
1140 - `BetaManagedAgentsWebFetchURLSourceNone object`
1141
1142 This source contributes no URLs that may be fetched.
1143
1144 - `type: "none"`
1145
1146 - `BetaManagedAgentsWebFetchURLSourceOnly object`
1147
1148 Only the named tools' results contribute URLs that may be fetched.
1149
1150 - `type: "only"`
1151
1152 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
1153
1154 The tools whose results contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "none" to allow no tool's results.
1155
1156 - `type: "tool_reference"`
1157
1158 Must be "tool_reference".
1159
1160 - `name: string`
1161
1162 Name of the tool. Compared exactly, so upper and lower case letters are different.
1163
1164 minLength: 1, maxLength: 128
1165
1166 - `BetaManagedAgentsWebFetchURLSourceExcept object`
1167
1168 Every tool's results contribute URLs that may be fetched, except the named tools' results.
1169
1170 - `type: "except"`
1171
1172 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
1173
1174 The tools whose results do not contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "all" to leave out no tool's results.
1175
1176 - `type: "tool_reference"`
1177
1178 Must be "tool_reference".
1179
1180 - `name: string`
1181
1182 Name of the tool. Compared exactly, so upper and lower case letters are different.
1183
1184 minLength: 1, maxLength: 128
1185
1186 - `server_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
1187
1188 Which of the web_search and web_fetch tools' results contribute URLs that may be fetched. Null when not set, which allows both.
1189
1190 - `user_input: BetaManagedAgentsWebFetchURLSourceUserInput or null`
1191
1192 Whether URLs in the text of user messages may be fetched. Null when not set, which allows them.
1193
1194 - `BetaManagedAgentsWebFetchURLSourceAll object`
1195
1196 Every URL from this source may be fetched. This is the default.
1197
1198 - `BetaManagedAgentsWebFetchURLSourceNone object`
1199
1200 This source contributes no URLs that may be fetched.
1201
1202 - `allowed_domains: optional array of string`
1203
1204 - `blocked_domains: optional array of string`
1205
1206 - `max_content_tokens: optional number or null`
1207
1208 format: int32
1209
1210 - `BetaManagedAgentsWebSearchToolConfig object`
1211
1212 Configuration for the web_search tool.
1213
1214 - `type: "web_search"`
1215
1216 - `enabled: boolean`
1217
1218 - `name: "web_search"`
1219
1220 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1221
1222 Permission policy for tool execution.
1223
1224 - `BetaManagedAgentsAlwaysAllowPolicy object`
1225
1226 Tool calls are automatically approved without user confirmation.
1227
1228 - `BetaManagedAgentsAlwaysAskPolicy object`
1229
1230 Tool calls require user confirmation before execution.
1231
1232 - `BetaManagedAgentsAutoPolicy object`
1233
1234 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1235
1236 - `allowed_domains: optional array of string`
1237
1238 - `blocked_domains: optional array of string`
1239
1240 - `user_location: optional BetaManagedAgentsUserLocation or null`
1241
1242 Approximate user location for search result localization.
1243
1244 - `type: "approximate"`
1245
1246 Location precision. Only "approximate" is supported.
1247
1248 - `city: optional string or null`
1249
1250 City name.
1251
1252 minLength: 1, maxLength: 255
1253
1254 - `country: optional string or null`
1255
1256 Two-letter ISO 3166-1 country code, uppercase.
1257
1258 - `region: optional string or null`
1259
1260 Region or state name.
1261
1262 minLength: 1, maxLength: 255
1263
1264 - `timezone: optional string or null`
1265
1266 IANA timezone identifier, e.g. "America/Los_Angeles".
1267
1268 minLength: 1, maxLength: 255
1269
1270 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
1271
1272 Resolved default configuration for agent tools.
9431273
9441274 - `enabled: boolean`
9451275
946 - `name: "bash"`
947
9481276 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
9491277
9501278 Permission policy for tool execution.
from line 1281
9531281
9541282 Tool calls are automatically approved without user confirmation.
9551283
956 - `type: "always_allow"`
957
9581284 - `BetaManagedAgentsAlwaysAskPolicy object`
9591285
9601286 Tool calls require user confirmation before execution.
9611287
962 - `type: "always_ask"`
963
9641288 - `BetaManagedAgentsAutoPolicy object`
9651289
9661290 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
9671291
968 - `type: "auto"`
969
970 - `BetaManagedAgentsEditToolConfig object`
971
972 Configuration for the edit tool.
973
974 - `type: "edit"`
1292 - `BetaManagedAgentsMCPToolset object`
1293
1294 - `type: "mcp_toolset"`
1295
1296 - `configs: array of BetaManagedAgentsMCPToolConfig`
9751297
9761298 - `enabled: boolean`
9771299
978 - `name: "edit"`
1300 - `name: string`
9791301
9801302 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
9811303
from line 1315
9931315
9941316 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
9951317
996 - `BetaManagedAgentsReadToolConfig object`
997
998 Configuration for the read tool.
999
1000 - `type: "read"`
1318 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
1319
1320 Resolved default configuration for all tools from an MCP server.
10011321
10021322 - `enabled: boolean`
10031323
1004 - `name: "read"`
1005
10061324 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
10071325
10081326 Permission policy for tool execution.
from line 1337
10191337
10201338 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
10211339
1022 - `BetaManagedAgentsWriteToolConfig object`
1023
1024 Configuration for the write tool.
1025
1026 - `type: "write"`
1027
1028 - `enabled: boolean`
1029
1030 - `name: "write"`
1031
1032 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1033
1034 Permission policy for tool execution.
1035
1036 - `BetaManagedAgentsAlwaysAllowPolicy object`
1037
1038 Tool calls are automatically approved without user confirmation.
1039
1040 - `BetaManagedAgentsAlwaysAskPolicy object`
1041
1042 Tool calls require user confirmation before execution.
1043
1044 - `BetaManagedAgentsAutoPolicy object`
1045
1046 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1047
1048 - `BetaManagedAgentsGlobToolConfig object`
1049
1050 Configuration for the glob tool.
1051
1052 - `type: "glob"`
1053
1054 - `enabled: boolean`
1055
1056 - `name: "glob"`
1057
1058 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1059
1060 Permission policy for tool execution.
1061
1062 - `BetaManagedAgentsAlwaysAllowPolicy object`
1063
1064 Tool calls are automatically approved without user confirmation.
1065
1066 - `BetaManagedAgentsAlwaysAskPolicy object`
1067
1068 Tool calls require user confirmation before execution.
1069
1070 - `BetaManagedAgentsAutoPolicy object`
1071
1072 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1073
1074 - `BetaManagedAgentsGrepToolConfig object`
1075
1076 Configuration for the grep tool.
1077
1078 - `type: "grep"`
1079
1080 - `enabled: boolean`
1081
1082 - `name: "grep"`
1083
1084 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1085
1086 Permission policy for tool execution.
1087
1088 - `BetaManagedAgentsAlwaysAllowPolicy object`
1089
1090 Tool calls are automatically approved without user confirmation.
1091
1092 - `BetaManagedAgentsAlwaysAskPolicy object`
1093
1094 Tool calls require user confirmation before execution.
1095
1096 - `BetaManagedAgentsAutoPolicy object`
1097
1098 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1099
1100 - `BetaManagedAgentsWebFetchToolConfig object`
1101
1102 Configuration for the web_fetch tool.
1103
1104 - `type: "web_fetch"`
1105
1106 - `enabled: boolean`
1107
1108 - `name: "web_fetch"`
1109
1110 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1111
1112 Permission policy for tool execution.
1113
1114 - `BetaManagedAgentsAlwaysAllowPolicy object`
1115
1116 Tool calls are automatically approved without user confirmation.
1117
1118 - `BetaManagedAgentsAlwaysAskPolicy object`
1119
1120 Tool calls require user confirmation before execution.
1121
1122 - `BetaManagedAgentsAutoPolicy object`
1123
1124 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1125
1126 - `url_sources: BetaManagedAgentsWebFetchURLSources or null`
1127
1128 Which sources contribute URLs the tool may fetch, always in the object form. Null when not set, which allows every source.
1129
1130 - `client_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
1131
1132 Which custom tools' results contribute URLs that may be fetched. Null when not set, which allows every custom tool's results.
1133
1134 - `BetaManagedAgentsWebFetchURLSourceAll object`
1135
1136 Every URL from this source may be fetched. This is the default.
1137
1138 - `type: "all"`
1139
1140 - `BetaManagedAgentsWebFetchURLSourceNone object`
1141
1142 This source contributes no URLs that may be fetched.
1143
1144 - `type: "none"`
1145
1146 - `BetaManagedAgentsWebFetchURLSourceOnly object`
1147
1148 Only the named tools' results contribute URLs that may be fetched.
1149
1150 - `type: "only"`
1151
1152 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
1153
1154 The tools whose results contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "none" to allow no tool's results.
1155
1156 - `type: "tool_reference"`
1157
1158 Must be "tool_reference".
1159
1160 - `name: string`
1161
1162 Name of the tool. Compared exactly, so upper and lower case letters are different.
1163
1164 minLength: 1, maxLength: 128
1165
1166 - `BetaManagedAgentsWebFetchURLSourceExcept object`
1167
1168 Every tool's results contribute URLs that may be fetched, except the named tools' results.
1169
1170 - `type: "except"`
1171
1172 - `tools: array of BetaManagedAgentsWebFetchURLSourceToolReference`
1173
1174 The tools whose results do not contribute. Between 1 and 128 entries, each with a different name. An empty list is rejected; use "all" to leave out no tool's results.
1175
1176 - `type: "tool_reference"`
1177
1178 Must be "tool_reference".
1179
1180 - `name: string`
1181
1182 Name of the tool. Compared exactly, so upper and lower case letters are different.
1183
1184 minLength: 1, maxLength: 128
1185
1186 - `server_tool_results: BetaManagedAgentsWebFetchURLSourceToolFilter or null`
1187
1188 Which of the web_search and web_fetch tools' results contribute URLs that may be fetched. Null when not set, which allows both.
1189
1190 - `user_input: BetaManagedAgentsWebFetchURLSourceUserInput or null`
1191
1192 Whether URLs in the text of user messages may be fetched. Null when not set, which allows them.
1193
1194 - `BetaManagedAgentsWebFetchURLSourceAll object`
1195
1196 Every URL from this source may be fetched. This is the default.
1197
1198 - `BetaManagedAgentsWebFetchURLSourceNone object`
1199
1200 This source contributes no URLs that may be fetched.
1201
1202 - `allowed_domains: optional array of string`
1203
1204 - `blocked_domains: optional array of string`
1205
1206 - `max_content_tokens: optional number or null`
1207
1208 format: int32
1209
1210 - `BetaManagedAgentsWebSearchToolConfig object`
1211
1212 Configuration for the web_search tool.
1213
1214 - `type: "web_search"`
1215
1216 - `enabled: boolean`
1217
1218 - `name: "web_search"`
1219
1220 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1221
1222 Permission policy for tool execution.
1223
1224 - `BetaManagedAgentsAlwaysAllowPolicy object`
1225
1226 Tool calls are automatically approved without user confirmation.
1227
1228 - `BetaManagedAgentsAlwaysAskPolicy object`
1229
1230 Tool calls require user confirmation before execution.
1231
1232 - `BetaManagedAgentsAutoPolicy object`
1233
1234 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1235
1236 - `allowed_domains: optional array of string`
1237
1238 - `blocked_domains: optional array of string`
1239
1240 - `user_location: optional BetaManagedAgentsUserLocation or null`
1241
1242 Approximate user location for search result localization.
1243
1244 - `type: "approximate"`
1245
1246 Location precision. Only "approximate" is supported.
1247
1248 - `city: optional string or null`
1249
1250 City name.
1251
1252 minLength: 1, maxLength: 255
1253
1254 - `country: optional string or null`
1255
1256 Two-letter ISO 3166-1 country code, uppercase.
1257
1258 - `region: optional string or null`
1259
1260 Region or state name.
1261
1262 minLength: 1, maxLength: 255
1263
1264 - `timezone: optional string or null`
1265
1266 IANA timezone identifier, e.g. "America/Los_Angeles".
1267
1268 minLength: 1, maxLength: 255
1269
1270 - `default_config: BetaManagedAgentsAgentToolsetDefaultConfig`
1271
1272 Resolved default configuration for agent tools.
1273
1274 - `enabled: boolean`
1275
1276 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1277
1278 Permission policy for tool execution.
1279
1280 - `BetaManagedAgentsAlwaysAllowPolicy object`
1281
1282 Tool calls are automatically approved without user confirmation.
1283
1284 - `BetaManagedAgentsAlwaysAskPolicy object`
1285
1286 Tool calls require user confirmation before execution.
1287
1288 - `BetaManagedAgentsAutoPolicy object`
1289
1290 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1291
1292 - `BetaManagedAgentsMCPToolset object`
1293
1294 - `type: "mcp_toolset"`
1295
1296 - `configs: array of BetaManagedAgentsMCPToolConfig`
1297
1298 - `enabled: boolean`
1340 - `mcp_server_name: string`
1341
1342 - `BetaManagedAgentsCustomTool object`
1343
1344 A custom tool as returned in API responses.
1345
1346 - `type: "custom"`
1347
1348 - `description: string`
1349
1350 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
1351
1352 JSON Schema for custom tool input parameters.
1353
1354 - `type: "object"`
1355
1356 - `properties: optional map[unknown] or null`
1357
1358 - `required: optional array of string or null`
12991359
13001360 - `name: string`
13011361
1302 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1303
1304 Permission policy for tool execution.
1305
1306 - `BetaManagedAgentsAlwaysAllowPolicy object`
1307
1308 Tool calls are automatically approved without user confirmation.
1309
1310 - `BetaManagedAgentsAlwaysAskPolicy object`
1311
1312 Tool calls require user confirmation before execution.
1313
1314 - `BetaManagedAgentsAutoPolicy object`
1315
1316 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1317
1318 - `default_config: BetaManagedAgentsMCPToolsetDefaultConfig`
1319
1320 Resolved default configuration for all tools from an MCP server.
1321
1322 - `enabled: boolean`
1323
1324 - `permission_policy: BetaManagedAgentsAlwaysAllowPolicy or BetaManagedAgentsAlwaysAskPolicy or BetaManagedAgentsAutoPolicy`
1325
1326 Permission policy for tool execution.
1327
1328 - `BetaManagedAgentsAlwaysAllowPolicy object`
1329
1330 Tool calls are automatically approved without user confirmation.
1331
1332 - `BetaManagedAgentsAlwaysAskPolicy object`
1333
1334 Tool calls require user confirmation before execution.
1335
1336 - `BetaManagedAgentsAutoPolicy object`
1337
1338 The server decides each tool call individually: it judges, from the tool, its input, and the session content so far, whether the call is safe to execute or high-risk, and evaluates it to allow when judged safe and to deny when judged high-risk. A call the server cannot reach a judgement on evaluates to ask.
1339
1340 - `mcp_server_name: string`
1341
1342 - `BetaManagedAgentsCustomTool object`
1343
1344 A custom tool as returned in API responses.
1345
1346 - `type: "custom"`
1347
1348 - `description: string`
1349
1350 - `input_schema: BetaManagedAgentsCustomToolInputSchema`
1351
1352 JSON Schema for custom tool input parameters.
1353
1354 - `type: "object"`
1355
1356 - `properties: optional map[unknown] or null`
1357
1358 - `required: optional array of string or null`
1362 - `version: number`
1363
1364 format: int32
1365
1366 - `BetaManagedAgentsAdvisor object`
1367
1368 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
1369
1370 - `type: "advisor"`
1371
1372 - `model: string`
1373
1374 The advisor model id.
1375
1376 - `BetaManagedAgentsSessionMultiagent20261001 object`
1377
1378 Resolved multiagent configuration with three members, as copied to the `session` at creation.
1379
1380 - `type: "multiagent_20261001"`
1381
1382 - `advisor: BetaManagedAgentsMultiagentAdvisor`
1383
1384 Whether the session's primary thread can consult an advisor model.
1385
1386 - `BetaManagedAgentsMultiagentAdvisorEnabled object`
1387
1388 The session's primary thread can consult `model` mid-turn.
1389
1390 - `type: "enabled"`
1391
1392 - `model: string`
1393
1394 The advisor model id.
1395
1396 - `BetaManagedAgentsMultiagentAdvisorDisabled object`
1397
1398 The agent has no advisor.
1399
1400 - `type: "disabled"`
1401
1402 - `subagents: BetaManagedAgentsSessionMultiagentSubagents`
1403
1404 Whether the agent can spawn session threads.
1405
1406 - `BetaManagedAgentsSessionMultiagentSubagentsEnabled object`
1407
1408 The agent can spawn session threads.
1409
1410 - `type: "enabled"`
1411
1412 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
1413
1414 Whether the agent can define inline agents, which are not saved, when it spawns session threads.
1415
1416 - `BetaManagedAgentsMultiagentInlineAgentsEnabled object`
1417
1418 The agent can define inline agents.
1419
1420 - `type: "enabled"`
1421
1422 - `BetaManagedAgentsMultiagentInlineAgentsDisabled object`
1423
1424 The agent cannot define inline agents.
1425
1426 - `type: "disabled"`
1427
1428 - `predefined_agents: array of BetaManagedAgentsSessionThreadAgent`
1429
1430 Full `agent` definitions of the predefined agents, which are saved agents that this agent can spawn as session threads.
1431
1432 - `type: "agent"`
1433
1434 - `id: string`
1435
1436 - `description: string or null`
1437
1438 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
1439
1440 - `model: BetaManagedAgentsModelConfig`
1441
1442 Model identifier and configuration.
13591443
13601444 - `name: string`
13611445
1362 - `version: number`
1363
1364 format: int32
1365
1366 - `BetaManagedAgentsAdvisor object`
1367
1368 Platform advisor roster entry: a model the session's primary thread may consult mid-turn.
1369
1370 - `type: "advisor"`
1371
1372 - `model: string`
1373
1374 The advisor model id.
1446 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
1447
1448 - `system: string or null`
1449
1450 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
1451
1452 - `version: number`
1453
1454 format: int32
1455
1456 - `BetaManagedAgentsMultiagentSubagentsDisabled object`
1457
1458 The agent cannot spawn session threads.
1459
1460 - `type: "disabled"`
1461
1462 - `workflows: BetaManagedAgentsSessionMultiagentWorkflows`
1463
1464 Whether the agent can start workflow runs.
1465
1466 - `BetaManagedAgentsSessionMultiagentWorkflowsEnabled object`
1467
1468 The agent can start workflow runs.
1469
1470 - `type: "enabled"`
1471
1472 - `inline_agents: BetaManagedAgentsMultiagentInlineAgents`
1473
1474 Whether a run's plan can define inline agents, which are not saved.
1475
1476 - `predefined_agents: array of BetaManagedAgentsSessionThreadAgent`
1477
1478 Full `agent` definitions of the predefined agents, which are saved agents that a run's plan can use.
1479
1480 - `type: "agent"`
1481
1482 - `id: string`
1483
1484 - `description: string or null`
1485
1486 - `mcp_servers: array of BetaManagedAgentsMCPServerURLDefinition`
1487
1488 - `model: BetaManagedAgentsModelConfig`
1489
1490 Model identifier and configuration.
1491
1492 - `name: string`
1493
1494 - `skills: array of BetaManagedAgentsAnthropicSkill or BetaManagedAgentsCustomSkill`
1495
1496 - `system: string or null`
1497
1498 - `tools: array of BetaManagedAgentsAgentToolset20260401 or BetaManagedAgentsMCPToolset or BetaManagedAgentsCustomTool`
1499
1500 - `version: number`
1501
1502 format: int32
1503
1504 - `BetaManagedAgentsMultiagentWorkflowsDisabled object`
1505
1506 The agent cannot start workflow runs.
1507
1508 - `type: "disabled"`
13751509
13761510 - `name: string`
13771511
13781512
No line in this hunk matches that.