What this read moved
51–75 of 256This capture is too large to show at once. Changes 51-75 of 256 are below, significant first; the rest are on the following screens.
api/messages Changed · +1106 / -0 lines
### Web Fetch URL Source All ### Web Fetch URL Source Except ### Web Fetch URL Source None ### Web Fetch URL Source Only ### Web Fetch URL Source Tool Reference ### Web Fetch URL Sources
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 2563
25632563
25642564 When true, guarantees schema validation on tool names and inputs
25652565
2566 - `url_sources: optional WebFetchURLSources or null`
2567
2568 Which sources contribute to the set of URLs web fetch may fetch.
2569
2570 Each key is a tagged variant: `user_input` is `all` or `none`; the
2571 two tool filters are `all`, `none`, `only` (only the named tools'
2572 results) or `except` (every result but the named tools'). A named tool
2573 must be declared in this request's `tools[]`.
2574
2575 - `client_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
2576
2577 Which client tools' results contribute fetchable URLs: "all", "none", or an only or except list of client tool names from tools[].
2578
2579 - `WebFetchURLSourceAll object`
2580
2581 The `url_sources` variant under which a source contributes in
2582 full: every result of the tool filter's source, or all user input.
2583
2584 - `type: "all"`
2585
2586 - `WebFetchURLSourceNone object`
2587
2588 The `url_sources` variant under which a source contributes nothing:
2589 no result of the tool filter's source, or no user input.
2590
2591 - `type: "none"`
2592
2593 - `WebFetchURLSourceOnly object`
2594
2595 The tool filter variant under which only the named tools' results
2596 contribute.
2597
2598 - `type: "only"`
2599
2600 - `tools: array of WebFetchURLSourceToolReference`
2601
2602 - `type: "tool_reference"`
2603
2604 - `name: string`
2605
2606 - `WebFetchURLSourceExcept object`
2607
2608 The tool filter variant under which every result but the named
2609 tools' contributes.
2610
2611 - `type: "except"`
2612
2613 - `tools: array of WebFetchURLSourceToolReference`
2614
2615 - `type: "tool_reference"`
2616
2617 - `name: string`
2618
2619 - `server_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
2620
2621 Which server tools' results contribute fetchable URLs: "all", "none", or an only or except list of server tool names from tools[]; only web_search and web_fetch results ever contribute.
2622
2623 - `WebFetchURLSourceAll object`
2624
2625 The `url_sources` variant under which a source contributes in
2626 full: every result of the tool filter's source, or all user input.
2627
2628 - `WebFetchURLSourceNone object`
2629
2630 The `url_sources` variant under which a source contributes nothing:
2631 no result of the tool filter's source, or no user input.
2632
2633 - `WebFetchURLSourceOnly object`
2634
2635 The tool filter variant under which only the named tools' results
2636 contribute.
2637
2638 - `WebFetchURLSourceExcept object`
2639
2640 The tool filter variant under which every result but the named
2641 tools' contributes.
2642
2643 - `user_input: optional WebFetchURLSourceAll or WebFetchURLSourceNone`
2644
2645 Whether URLs in user messages are fetchable: "all" or "none".
2646
2647 - `WebFetchURLSourceAll object`
2648
2649 The `url_sources` variant under which a source contributes in
2650 full: every result of the tool filter's source, or all user input.
2651
2652 - `WebFetchURLSourceNone object`
2653
2654 The `url_sources` variant under which a source contributes nothing:
2655 no result of the tool filter's source, or no user input.
2656
25662657 - `WebSearchTool20260209 object`
25672658
25682659 - `type: "web_search_20260209"`
from line 2760
26692760
26702761 When true, guarantees schema validation on tool names and inputs
26712762
2763 - `url_sources: optional WebFetchURLSources or null`
2764
2765 Which sources contribute to the set of URLs web fetch may fetch.
2766
2767 Each key is a tagged variant: `user_input` is `all` or `none`; the
2768 two tool filters are `all`, `none`, `only` (only the named tools'
2769 results) or `except` (every result but the named tools'). A named tool
2770 must be declared in this request's `tools[]`.
2771
26722772 - `WebFetchTool20260309 object`
26732773
26742774 Web fetch tool with use_cache parameter for bypassing cached content.
from line 2827
27272827
27282828 When true, guarantees schema validation on tool names and inputs
27292829
2830 - `url_sources: optional WebFetchURLSources or null`
2831
2832 Which sources contribute to the set of URLs web fetch may fetch.
2833
2834 Each key is a tagged variant: `user_input` is `all` or `none`; the
2835 two tool filters are `all`, `none`, `only` (only the named tools'
2836 results) or `except` (every result but the named tools'). A named tool
2837 must be declared in this request's `tools[]`.
2838
27302839 - `use_cache: optional boolean`
27312840
27322841 Whether to use cached content. Set to false to bypass the cache and fetch fresh content. Only set to false when the user explicitly requests fresh content or when fetching rapidly-changing sources.
from line 2961
28522961 - `strict: optional boolean`
28532962
28542963 When true, guarantees schema validation on tool names and inputs
2964
2965 - `url_sources: optional WebFetchURLSources or null`
2966
2967 Which sources contribute to the set of URLs web fetch may fetch.
2968
2969 Each key is a tagged variant: `user_input` is `all` or `none`; the
2970 two tool filters are `all`, `none`, `only` (only the named tools'
2971 results) or `except` (every result but the named tools'). A named tool
2972 must be declared in this request's `tools[]`.
28552973
28562974 - `use_cache: optional boolean`
28572975
from line 6894
67766894
67776895 When true, guarantees schema validation on tool names and inputs
67786896
6897 - `url_sources: optional WebFetchURLSources or null`
6898
6899 Which sources contribute to the set of URLs web fetch may fetch.
6900
6901 Each key is a tagged variant: `user_input` is `all` or `none`; the
6902 two tool filters are `all`, `none`, `only` (only the named tools'
6903 results) or `except` (every result but the named tools'). A named tool
6904 must be declared in this request's `tools[]`.
6905
6906 - `client_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
6907
6908 Which client tools' results contribute fetchable URLs: "all", "none", or an only or except list of client tool names from tools[].
6909
6910 - `WebFetchURLSourceAll object`
6911
6912 The `url_sources` variant under which a source contributes in
6913 full: every result of the tool filter's source, or all user input.
6914
6915 - `type: "all"`
6916
6917 - `WebFetchURLSourceNone object`
6918
6919 The `url_sources` variant under which a source contributes nothing:
6920 no result of the tool filter's source, or no user input.
6921
6922 - `type: "none"`
6923
6924 - `WebFetchURLSourceOnly object`
6925
6926 The tool filter variant under which only the named tools' results
6927 contribute.
6928
6929 - `type: "only"`
6930
6931 - `tools: array of WebFetchURLSourceToolReference`
6932
6933 - `type: "tool_reference"`
6934
6935 - `name: string`
6936
6937 - `WebFetchURLSourceExcept object`
6938
6939 The tool filter variant under which every result but the named
6940 tools' contributes.
6941
6942 - `type: "except"`
6943
6944 - `tools: array of WebFetchURLSourceToolReference`
6945
6946 - `type: "tool_reference"`
6947
6948 - `name: string`
6949
6950 - `server_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
6951
6952 Which server tools' results contribute fetchable URLs: "all", "none", or an only or except list of server tool names from tools[]; only web_search and web_fetch results ever contribute.
6953
6954 - `WebFetchURLSourceAll object`
6955
6956 The `url_sources` variant under which a source contributes in
6957 full: every result of the tool filter's source, or all user input.
6958
6959 - `WebFetchURLSourceNone object`
6960
6961 The `url_sources` variant under which a source contributes nothing:
6962 no result of the tool filter's source, or no user input.
6963
6964 - `WebFetchURLSourceOnly object`
6965
6966 The tool filter variant under which only the named tools' results
6967 contribute.
6968
6969 - `WebFetchURLSourceExcept object`
6970
6971 The tool filter variant under which every result but the named
6972 tools' contributes.
6973
6974 - `user_input: optional WebFetchURLSourceAll or WebFetchURLSourceNone`
6975
6976 Whether URLs in user messages are fetchable: "all" or "none".
6977
6978 - `WebFetchURLSourceAll object`
6979
6980 The `url_sources` variant under which a source contributes in
6981 full: every result of the tool filter's source, or all user input.
6982
6983 - `WebFetchURLSourceNone object`
6984
6985 The `url_sources` variant under which a source contributes nothing:
6986 no result of the tool filter's source, or no user input.
6987
67796988 - `WebSearchTool20260209 object`
67806989
67816990 - `type: "web_search_20260209"`
from line 7091
68827091
68837092 When true, guarantees schema validation on tool names and inputs
68847093
7094 - `url_sources: optional WebFetchURLSources or null`
7095
7096 Which sources contribute to the set of URLs web fetch may fetch.
7097
7098 Each key is a tagged variant: `user_input` is `all` or `none`; the
7099 two tool filters are `all`, `none`, `only` (only the named tools'
7100 results) or `except` (every result but the named tools'). A named tool
7101 must be declared in this request's `tools[]`.
7102
68857103 - `WebFetchTool20260309 object`
68867104
68877105 Web fetch tool with use_cache parameter for bypassing cached content.
from line 7158
69407158
69417159 When true, guarantees schema validation on tool names and inputs
69427160
7161 - `url_sources: optional WebFetchURLSources or null`
7162
7163 Which sources contribute to the set of URLs web fetch may fetch.
7164
7165 Each key is a tagged variant: `user_input` is `all` or `none`; the
7166 two tool filters are `all`, `none`, `only` (only the named tools'
7167 results) or `except` (every result but the named tools'). A named tool
7168 must be declared in this request's `tools[]`.
7169
69437170 - `use_cache: optional boolean`
69447171
69457172 Whether to use cached content. Set to false to bypass the cache and fetch fresh content. Only set to false when the user explicitly requests fresh content or when fetching rapidly-changing sources.
from line 7292
70657292 - `strict: optional boolean`
70667293
70677294 When true, guarantees schema validation on tool names and inputs
7295
7296 - `url_sources: optional WebFetchURLSources or null`
7297
7298 Which sources contribute to the set of URLs web fetch may fetch.
7299
7300 Each key is a tagged variant: `user_input` is `all` or `none`; the
7301 two tool filters are `all`, `none`, `only` (only the named tools'
7302 results) or `except` (every result but the named tools'). A named tool
7303 must be declared in this request's `tools[]`.
70687304
70697305 - `use_cache: optional boolean`
70707306
from line 16006
1577016006
1577116007 When true, guarantees schema validation on tool names and inputs
1577216008
16009 - `url_sources: optional WebFetchURLSources or null`
16010
16011 Which sources contribute to the set of URLs web fetch may fetch.
16012
16013 Each key is a tagged variant: `user_input` is `all` or `none`; the
16014 two tool filters are `all`, `none`, `only` (only the named tools'
16015 results) or `except` (every result but the named tools'). A named tool
16016 must be declared in this request's `tools[]`.
16017
16018 - `client_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
16019
16020 Which client tools' results contribute fetchable URLs: "all", "none", or an only or except list of client tool names from tools[].
16021
16022 - `WebFetchURLSourceAll object`
16023
16024 The `url_sources` variant under which a source contributes in
16025 full: every result of the tool filter's source, or all user input.
16026
16027 - `type: "all"`
16028
16029 - `WebFetchURLSourceNone object`
16030
16031 The `url_sources` variant under which a source contributes nothing:
16032 no result of the tool filter's source, or no user input.
16033
16034 - `type: "none"`
16035
16036 - `WebFetchURLSourceOnly object`
16037
16038 The tool filter variant under which only the named tools' results
16039 contribute.
16040
16041 - `type: "only"`
16042
16043 - `tools: array of WebFetchURLSourceToolReference`
16044
16045 - `type: "tool_reference"`
16046
16047 - `name: string`
16048
16049 - `WebFetchURLSourceExcept object`
16050
16051 The tool filter variant under which every result but the named
16052 tools' contributes.
16053
16054 - `type: "except"`
16055
16056 - `tools: array of WebFetchURLSourceToolReference`
16057
16058 - `type: "tool_reference"`
16059
16060 - `name: string`
16061
16062 - `server_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
16063
16064 Which server tools' results contribute fetchable URLs: "all", "none", or an only or except list of server tool names from tools[]; only web_search and web_fetch results ever contribute.
16065
16066 - `WebFetchURLSourceAll object`
16067
16068 The `url_sources` variant under which a source contributes in
16069 full: every result of the tool filter's source, or all user input.
16070
16071 - `WebFetchURLSourceNone object`
16072
16073 The `url_sources` variant under which a source contributes nothing:
16074 no result of the tool filter's source, or no user input.
16075
16076 - `WebFetchURLSourceOnly object`
16077
16078 The tool filter variant under which only the named tools' results
16079 contribute.
16080
16081 - `WebFetchURLSourceExcept object`
16082
16083 The tool filter variant under which every result but the named
16084 tools' contributes.
16085
16086 - `user_input: optional WebFetchURLSourceAll or WebFetchURLSourceNone`
16087
16088 Whether URLs in user messages are fetchable: "all" or "none".
16089
16090 - `WebFetchURLSourceAll object`
16091
16092 The `url_sources` variant under which a source contributes in
16093 full: every result of the tool filter's source, or all user input.
16094
16095 - `WebFetchURLSourceNone object`
16096
16097 The `url_sources` variant under which a source contributes nothing:
16098 no result of the tool filter's source, or no user input.
16099
1577316100 - `WebSearchTool20260209 object`
1577416101
1577516102 - `type: "web_search_20260209"`
from line 16203
1587616203
1587716204 When true, guarantees schema validation on tool names and inputs
1587816205
16206 - `url_sources: optional WebFetchURLSources or null`
16207
16208 Which sources contribute to the set of URLs web fetch may fetch.
16209
16210 Each key is a tagged variant: `user_input` is `all` or `none`; the
16211 two tool filters are `all`, `none`, `only` (only the named tools'
16212 results) or `except` (every result but the named tools'). A named tool
16213 must be declared in this request's `tools[]`.
16214
1587916215 - `WebFetchTool20260309 object`
1588016216
1588116217 Web fetch tool with use_cache parameter for bypassing cached content.
from line 16270
1593416270
1593516271 When true, guarantees schema validation on tool names and inputs
1593616272
16273 - `url_sources: optional WebFetchURLSources or null`
16274
16275 Which sources contribute to the set of URLs web fetch may fetch.
16276
16277 Each key is a tagged variant: `user_input` is `all` or `none`; the
16278 two tool filters are `all`, `none`, `only` (only the named tools'
16279 results) or `except` (every result but the named tools'). A named tool
16280 must be declared in this request's `tools[]`.
16281
1593716282 - `use_cache: optional boolean`
1593816283
1593916284 Whether to use cached content. Set to false to bypass the cache and fetch fresh content. Only set to false when the user explicitly requests fresh content or when fetching rapidly-changing sources.
from line 16404
1605916404 - `strict: optional boolean`
1606016405
1606116406 When true, guarantees schema validation on tool names and inputs
16407
16408 - `url_sources: optional WebFetchURLSources or null`
16409
16410 Which sources contribute to the set of URLs web fetch may fetch.
16411
16412 Each key is a tagged variant: `user_input` is `all` or `none`; the
16413 two tool filters are `all`, `none`, `only` (only the named tools'
16414 results) or `except` (every result but the named tools'). A named tool
16415 must be declared in this request's `tools[]`.
1606216416
1606316417 - `use_cache: optional boolean`
1606416418
from line 25158
2480425158
2480525159 When true, guarantees schema validation on tool names and inputs
2480625160
25161 - `url_sources: optional WebFetchURLSources or null`
25162
25163 Which sources contribute to the set of URLs web fetch may fetch.
25164
25165 Each key is a tagged variant: `user_input` is `all` or `none`; the
25166 two tool filters are `all`, `none`, `only` (only the named tools'
25167 results) or `except` (every result but the named tools'). A named tool
25168 must be declared in this request's `tools[]`.
25169
25170 - `client_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
25171
25172 Which client tools' results contribute fetchable URLs: "all", "none", or an only or except list of client tool names from tools[].
25173
25174 - `WebFetchURLSourceAll object`
25175
25176 The `url_sources` variant under which a source contributes in
25177 full: every result of the tool filter's source, or all user input.
25178
25179 - `type: "all"`
25180
25181 - `WebFetchURLSourceNone object`
25182
25183 The `url_sources` variant under which a source contributes nothing:
25184 no result of the tool filter's source, or no user input.
25185
25186 - `type: "none"`
25187
25188 - `WebFetchURLSourceOnly object`
25189
25190 The tool filter variant under which only the named tools' results
25191 contribute.
25192
25193 - `type: "only"`
25194
25195 - `tools: array of WebFetchURLSourceToolReference`
25196
25197 - `type: "tool_reference"`
25198
25199 - `name: string`
25200
25201 - `WebFetchURLSourceExcept object`
25202
25203 The tool filter variant under which every result but the named
25204 tools' contributes.
25205
25206 - `type: "except"`
25207
25208 - `tools: array of WebFetchURLSourceToolReference`
25209
25210 - `type: "tool_reference"`
25211
25212 - `name: string`
25213
25214 - `server_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
25215
25216 Which server tools' results contribute fetchable URLs: "all", "none", or an only or except list of server tool names from tools[]; only web_search and web_fetch results ever contribute.
25217
25218 - `WebFetchURLSourceAll object`
25219
25220 The `url_sources` variant under which a source contributes in
25221 full: every result of the tool filter's source, or all user input.
25222
25223 - `WebFetchURLSourceNone object`
25224
25225 The `url_sources` variant under which a source contributes nothing:
25226 no result of the tool filter's source, or no user input.
25227
25228 - `WebFetchURLSourceOnly object`
25229
25230 The tool filter variant under which only the named tools' results
25231 contribute.
25232
25233 - `WebFetchURLSourceExcept object`
25234
25235 The tool filter variant under which every result but the named
25236 tools' contributes.
25237
25238 - `user_input: optional WebFetchURLSourceAll or WebFetchURLSourceNone`
25239
25240 Whether URLs in user messages are fetchable: "all" or "none".
25241
25242 - `WebFetchURLSourceAll object`
25243
25244 The `url_sources` variant under which a source contributes in
25245 full: every result of the tool filter's source, or all user input.
25246
25247 - `WebFetchURLSourceNone object`
25248
25249 The `url_sources` variant under which a source contributes nothing:
25250 no result of the tool filter's source, or no user input.
25251
2480725252 - `WebSearchTool20260209 object`
2480825253
2480925254 - `type: "web_search_20260209"`
from line 25355
2491025355
2491125356 When true, guarantees schema validation on tool names and inputs
2491225357
25358 - `url_sources: optional WebFetchURLSources or null`
25359
25360 Which sources contribute to the set of URLs web fetch may fetch.
25361
25362 Each key is a tagged variant: `user_input` is `all` or `none`; the
25363 two tool filters are `all`, `none`, `only` (only the named tools'
25364 results) or `except` (every result but the named tools'). A named tool
25365 must be declared in this request's `tools[]`.
25366
2491325367 - `WebFetchTool20260309 object`
2491425368
2491525369 Web fetch tool with use_cache parameter for bypassing cached content.
from line 25422
2496825422
2496925423 When true, guarantees schema validation on tool names and inputs
2497025424
25425 - `url_sources: optional WebFetchURLSources or null`
25426
25427 Which sources contribute to the set of URLs web fetch may fetch.
25428
25429 Each key is a tagged variant: `user_input` is `all` or `none`; the
25430 two tool filters are `all`, `none`, `only` (only the named tools'
25431 results) or `except` (every result but the named tools'). A named tool
25432 must be declared in this request's `tools[]`.
25433
2497125434 - `use_cache: optional boolean`
2497225435
2497325436 Whether to use cached content. Set to false to bypass the cache and fetch fresh content. Only set to false when the user explicitly requests fresh content or when fetching rapidly-changing sources.
from line 25556
2509325556 - `strict: optional boolean`
2509425557
2509525558 When true, guarantees schema validation on tool names and inputs
25559
25560 - `url_sources: optional WebFetchURLSources or null`
25561
25562 Which sources contribute to the set of URLs web fetch may fetch.
25563
25564 Each key is a tagged variant: `user_input` is `all` or `none`; the
25565 two tool filters are `all`, `none`, `only` (only the named tools'
25566 results) or `except` (every result but the named tools'). A named tool
25567 must be declared in this request's `tools[]`.
2509625568
2509725569 - `use_cache: optional boolean`
2509825570
from line 26315
2584326315
2584426316 When true, guarantees schema validation on tool names and inputs
2584526317
26318 - `url_sources: optional WebFetchURLSources or null`
26319
26320 Which sources contribute to the set of URLs web fetch may fetch.
26321
26322 Each key is a tagged variant: `user_input` is `all` or `none`; the
26323 two tool filters are `all`, `none`, `only` (only the named tools'
26324 results) or `except` (every result but the named tools'). A named tool
26325 must be declared in this request's `tools[]`.
26326
26327 - `client_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
26328
26329 Which client tools' results contribute fetchable URLs: "all", "none", or an only or except list of client tool names from tools[].
26330
26331 - `WebFetchURLSourceAll object`
26332
26333 The `url_sources` variant under which a source contributes in
26334 full: every result of the tool filter's source, or all user input.
26335
26336 - `type: "all"`
26337
26338 - `WebFetchURLSourceNone object`
26339
26340 The `url_sources` variant under which a source contributes nothing:
26341 no result of the tool filter's source, or no user input.
26342
26343 - `type: "none"`
26344
26345 - `WebFetchURLSourceOnly object`
26346
26347 The tool filter variant under which only the named tools' results
26348 contribute.
26349
26350 - `type: "only"`
26351
26352 - `tools: array of WebFetchURLSourceToolReference`
26353
26354 - `type: "tool_reference"`
26355
26356 - `name: string`
26357
26358 - `WebFetchURLSourceExcept object`
26359
26360 The tool filter variant under which every result but the named
26361 tools' contributes.
26362
26363 - `type: "except"`
26364
26365 - `tools: array of WebFetchURLSourceToolReference`
26366
26367 - `type: "tool_reference"`
26368
26369 - `name: string`
26370
26371 - `server_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
26372
26373 Which server tools' results contribute fetchable URLs: "all", "none", or an only or except list of server tool names from tools[]; only web_search and web_fetch results ever contribute.
26374
26375 - `WebFetchURLSourceAll object`
26376
26377 The `url_sources` variant under which a source contributes in
26378 full: every result of the tool filter's source, or all user input.
26379
26380 - `WebFetchURLSourceNone object`
26381
26382 The `url_sources` variant under which a source contributes nothing:
26383 no result of the tool filter's source, or no user input.
26384
26385 - `WebFetchURLSourceOnly object`
26386
26387 The tool filter variant under which only the named tools' results
26388 contribute.
26389
26390 - `WebFetchURLSourceExcept object`
26391
26392 The tool filter variant under which every result but the named
26393 tools' contributes.
26394
26395 - `user_input: optional WebFetchURLSourceAll or WebFetchURLSourceNone`
26396
26397 Whether URLs in user messages are fetchable: "all" or "none".
26398
26399 - `WebFetchURLSourceAll object`
26400
26401 The `url_sources` variant under which a source contributes in
26402 full: every result of the tool filter's source, or all user input.
26403
26404 - `WebFetchURLSourceNone object`
26405
26406 The `url_sources` variant under which a source contributes nothing:
26407 no result of the tool filter's source, or no user input.
26408
2584626409### Web Fetch Tool 20260209
2584726410
2584826411- `WebFetchTool20260209 object`
from line 26483
2592026483
2592126484 When true, guarantees schema validation on tool names and inputs
2592226485
26486 - `url_sources: optional WebFetchURLSources or null`
26487
26488 Which sources contribute to the set of URLs web fetch may fetch.
26489
26490 Each key is a tagged variant: `user_input` is `all` or `none`; the
26491 two tool filters are `all`, `none`, `only` (only the named tools'
26492 results) or `except` (every result but the named tools'). A named tool
26493 must be declared in this request's `tools[]`.
26494
26495 - `client_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
26496
26497 Which client tools' results contribute fetchable URLs: "all", "none", or an only or except list of client tool names from tools[].
26498
26499 - `WebFetchURLSourceAll object`
26500
26501 The `url_sources` variant under which a source contributes in
26502 full: every result of the tool filter's source, or all user input.
26503
26504 - `type: "all"`
26505
26506 - `WebFetchURLSourceNone object`
26507
26508 The `url_sources` variant under which a source contributes nothing:
26509 no result of the tool filter's source, or no user input.
26510
26511 - `type: "none"`
26512
26513 - `WebFetchURLSourceOnly object`
26514
26515 The tool filter variant under which only the named tools' results
26516 contribute.
26517
26518 - `type: "only"`
26519
26520 - `tools: array of WebFetchURLSourceToolReference`
26521
26522 - `type: "tool_reference"`
26523
26524 - `name: string`
26525
26526 - `WebFetchURLSourceExcept object`
26527
26528 The tool filter variant under which every result but the named
26529 tools' contributes.
26530
26531 - `type: "except"`
26532
26533 - `tools: array of WebFetchURLSourceToolReference`
26534
26535 - `type: "tool_reference"`
26536
26537 - `name: string`
26538
26539 - `server_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
26540
26541 Which server tools' results contribute fetchable URLs: "all", "none", or an only or except list of server tool names from tools[]; only web_search and web_fetch results ever contribute.
26542
26543 - `WebFetchURLSourceAll object`
26544
26545 The `url_sources` variant under which a source contributes in
26546 full: every result of the tool filter's source, or all user input.
26547
26548 - `WebFetchURLSourceNone object`
26549
26550 The `url_sources` variant under which a source contributes nothing:
26551 no result of the tool filter's source, or no user input.
26552
26553 - `WebFetchURLSourceOnly object`
26554
26555 The tool filter variant under which only the named tools' results
26556 contribute.
26557
26558 - `WebFetchURLSourceExcept object`
26559
26560 The tool filter variant under which every result but the named
26561 tools' contributes.
26562
26563 - `user_input: optional WebFetchURLSourceAll or WebFetchURLSourceNone`
26564
26565 Whether URLs in user messages are fetchable: "all" or "none".
26566
26567 - `WebFetchURLSourceAll object`
26568
26569 The `url_sources` variant under which a source contributes in
26570 full: every result of the tool filter's source, or all user input.
26571
26572 - `WebFetchURLSourceNone object`
26573
26574 The `url_sources` variant under which a source contributes nothing:
26575 no result of the tool filter's source, or no user input.
26576
2592326577### Web Fetch Tool 20260309
2592426578
2592526579- `WebFetchTool20260309 object`
from line 26653
2599926653
2600026654 When true, guarantees schema validation on tool names and inputs
2600126655
26656 - `url_sources: optional WebFetchURLSources or null`
26657
26658 Which sources contribute to the set of URLs web fetch may fetch.
26659
26660 Each key is a tagged variant: `user_input` is `all` or `none`; the
26661 two tool filters are `all`, `none`, `only` (only the named tools'
26662 results) or `except` (every result but the named tools'). A named tool
26663 must be declared in this request's `tools[]`.
26664
26665 - `client_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
26666
26667 Which client tools' results contribute fetchable URLs: "all", "none", or an only or except list of client tool names from tools[].
26668
26669 - `WebFetchURLSourceAll object`
26670
26671 The `url_sources` variant under which a source contributes in
26672 full: every result of the tool filter's source, or all user input.
26673
26674 - `type: "all"`
26675
26676 - `WebFetchURLSourceNone object`
26677
26678 The `url_sources` variant under which a source contributes nothing:
26679 no result of the tool filter's source, or no user input.
26680
26681 - `type: "none"`
26682
26683 - `WebFetchURLSourceOnly object`
26684
26685 The tool filter variant under which only the named tools' results
26686 contribute.
26687
26688 - `type: "only"`
26689
26690 - `tools: array of WebFetchURLSourceToolReference`
26691
26692 - `type: "tool_reference"`
26693
26694 - `name: string`
26695
26696 - `WebFetchURLSourceExcept object`
26697
26698 The tool filter variant under which every result but the named
26699 tools' contributes.
26700
26701 - `type: "except"`
26702
26703 - `tools: array of WebFetchURLSourceToolReference`
26704
26705 - `type: "tool_reference"`
26706
26707 - `name: string`
26708
26709 - `server_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
26710
26711 Which server tools' results contribute fetchable URLs: "all", "none", or an only or except list of server tool names from tools[]; only web_search and web_fetch results ever contribute.
26712
26713 - `WebFetchURLSourceAll object`
26714
26715 The `url_sources` variant under which a source contributes in
26716 full: every result of the tool filter's source, or all user input.
26717
26718 - `WebFetchURLSourceNone object`
26719
26720 The `url_sources` variant under which a source contributes nothing:
26721 no result of the tool filter's source, or no user input.
26722
26723 - `WebFetchURLSourceOnly object`
26724
26725 The tool filter variant under which only the named tools' results
26726 contribute.
26727
26728 - `WebFetchURLSourceExcept object`
26729
26730 The tool filter variant under which every result but the named
26731 tools' contributes.
26732
26733 - `user_input: optional WebFetchURLSourceAll or WebFetchURLSourceNone`
26734
26735 Whether URLs in user messages are fetchable: "all" or "none".
26736
26737 - `WebFetchURLSourceAll object`
26738
26739 The `url_sources` variant under which a source contributes in
26740 full: every result of the tool filter's source, or all user input.
26741
26742 - `WebFetchURLSourceNone object`
26743
26744 The `url_sources` variant under which a source contributes nothing:
26745 no result of the tool filter's source, or no user input.
26746
2600226747 - `use_cache: optional boolean`
2600326748
2600426749 Whether to use cached content. Set to false to bypass the cache and fetch fresh content. Only set to false when the user explicitly requests fresh content or when fetching rapidly-changing sources.
from line 26833
2608826833
2608926834 When true, guarantees schema validation on tool names and inputs
2609026835
26836 - `url_sources: optional WebFetchURLSources or null`
26837
26838 Which sources contribute to the set of URLs web fetch may fetch.
26839
26840 Each key is a tagged variant: `user_input` is `all` or `none`; the
26841 two tool filters are `all`, `none`, `only` (only the named tools'
26842 results) or `except` (every result but the named tools'). A named tool
26843 must be declared in this request's `tools[]`.
26844
26845 - `client_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
26846
26847 Which client tools' results contribute fetchable URLs: "all", "none", or an only or except list of client tool names from tools[].
26848
26849 - `WebFetchURLSourceAll object`
26850
26851 The `url_sources` variant under which a source contributes in
26852 full: every result of the tool filter's source, or all user input.
26853
26854 - `type: "all"`
26855
26856 - `WebFetchURLSourceNone object`
26857
26858 The `url_sources` variant under which a source contributes nothing:
26859 no result of the tool filter's source, or no user input.
26860
26861 - `type: "none"`
26862
26863 - `WebFetchURLSourceOnly object`
26864
26865 The tool filter variant under which only the named tools' results
26866 contribute.
26867
26868 - `type: "only"`
26869
26870 - `tools: array of WebFetchURLSourceToolReference`
26871
26872 - `type: "tool_reference"`
26873
26874 - `name: string`
26875
26876 - `WebFetchURLSourceExcept object`
26877
26878 The tool filter variant under which every result but the named
26879 tools' contributes.
26880
26881 - `type: "except"`
26882
26883 - `tools: array of WebFetchURLSourceToolReference`
26884
26885 - `type: "tool_reference"`
26886
26887 - `name: string`
26888
26889 - `server_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
26890
26891 Which server tools' results contribute fetchable URLs: "all", "none", or an only or except list of server tool names from tools[]; only web_search and web_fetch results ever contribute.
26892
26893 - `WebFetchURLSourceAll object`
26894
26895 The `url_sources` variant under which a source contributes in
26896 full: every result of the tool filter's source, or all user input.
26897
26898 - `WebFetchURLSourceNone object`
26899
26900 The `url_sources` variant under which a source contributes nothing:
26901 no result of the tool filter's source, or no user input.
26902
26903 - `WebFetchURLSourceOnly object`
26904
26905 The tool filter variant under which only the named tools' results
26906 contribute.
26907
26908 - `WebFetchURLSourceExcept object`
26909
26910 The tool filter variant under which every result but the named
26911 tools' contributes.
26912
26913 - `user_input: optional WebFetchURLSourceAll or WebFetchURLSourceNone`
26914
26915 Whether URLs in user messages are fetchable: "all" or "none".
26916
26917 - `WebFetchURLSourceAll object`
26918
26919 The `url_sources` variant under which a source contributes in
26920 full: every result of the tool filter's source, or all user input.
26921
26922 - `WebFetchURLSourceNone object`
26923
26924 The `url_sources` variant under which a source contributes nothing:
26925 no result of the tool filter's source, or no user input.
26926
2609126927 - `use_cache: optional boolean`
2609226928
2609326929 Whether to use cached content. Set to false to bypass the cache and fetch fresh content. Only set to false when the user explicitly requests fresh content or when fetching rapidly-changing sources.
from line 27476
2664027476 - `"unavailable"`
2664127477
2664227478 - `"content_too_large"`
27479
27480### Web Fetch URL Source All
27481
27482- `WebFetchURLSourceAll object`
27483
27484 The `url_sources` variant under which a source contributes in
27485 full: every result of the tool filter's source, or all user input.
27486
27487 - `type: "all"`
27488
27489### Web Fetch URL Source Except
27490
27491- `WebFetchURLSourceExcept object`
27492
27493 The tool filter variant under which every result but the named
27494 tools' contributes.
27495
27496 - `type: "except"`
27497
27498 - `tools: array of WebFetchURLSourceToolReference`
27499
27500 - `type: "tool_reference"`
27501
27502 - `name: string`
27503
27504### Web Fetch URL Source None
27505
27506- `WebFetchURLSourceNone object`
27507
27508 The `url_sources` variant under which a source contributes nothing:
27509 no result of the tool filter's source, or no user input.
27510
27511 - `type: "none"`
27512
27513### Web Fetch URL Source Only
27514
27515- `WebFetchURLSourceOnly object`
27516
27517 The tool filter variant under which only the named tools' results
27518 contribute.
27519
27520 - `type: "only"`
27521
27522 - `tools: array of WebFetchURLSourceToolReference`
27523
27524 - `type: "tool_reference"`
27525
27526 - `name: string`
27527
27528### Web Fetch URL Source Tool Reference
27529
27530- `WebFetchURLSourceToolReference object`
27531
27532 One entry of a tool filter's `tools`: it must name a tool declared
27533 in this request's `tools[]`.
27534
27535 - `type: "tool_reference"`
27536
27537 - `name: string`
27538
27539### Web Fetch URL Sources
27540
27541- `WebFetchURLSources object`
27542
27543 Which sources contribute to the set of URLs web fetch may fetch.
27544
27545 Each key is a tagged variant: `user_input` is `all` or `none`; the
27546 two tool filters are `all`, `none`, `only` (only the named tools'
27547 results) or `except` (every result but the named tools'). A named tool
27548 must be declared in this request's `tools[]`.
27549
27550 - `client_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
27551
27552 Which client tools' results contribute fetchable URLs: "all", "none", or an only or except list of client tool names from tools[].
27553
27554 - `WebFetchURLSourceAll object`
27555
27556 The `url_sources` variant under which a source contributes in
27557 full: every result of the tool filter's source, or all user input.
27558
27559 - `type: "all"`
27560
27561 - `WebFetchURLSourceNone object`
27562
27563 The `url_sources` variant under which a source contributes nothing:
27564 no result of the tool filter's source, or no user input.
27565
27566 - `type: "none"`
27567
27568 - `WebFetchURLSourceOnly object`
27569
27570 The tool filter variant under which only the named tools' results
27571 contribute.
27572
27573 - `type: "only"`
27574
27575 - `tools: array of WebFetchURLSourceToolReference`
27576
27577 - `type: "tool_reference"`
27578
27579 - `name: string`
27580
27581 - `WebFetchURLSourceExcept object`
27582
27583 The tool filter variant under which every result but the named
27584 tools' contributes.
27585
27586 - `type: "except"`
27587
27588 - `tools: array of WebFetchURLSourceToolReference`
27589
27590 - `type: "tool_reference"`
27591
27592 - `name: string`
27593
27594 - `server_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
27595
27596 Which server tools' results contribute fetchable URLs: "all", "none", or an only or except list of server tool names from tools[]; only web_search and web_fetch results ever contribute.
27597
27598 - `WebFetchURLSourceAll object`
27599
27600 The `url_sources` variant under which a source contributes in
27601 full: every result of the tool filter's source, or all user input.
27602
27603 - `WebFetchURLSourceNone object`
27604
27605 The `url_sources` variant under which a source contributes nothing:
27606 no result of the tool filter's source, or no user input.
27607
27608 - `WebFetchURLSourceOnly object`
27609
27610 The tool filter variant under which only the named tools' results
27611 contribute.
27612
27613 - `WebFetchURLSourceExcept object`
27614
27615 The tool filter variant under which every result but the named
27616 tools' contributes.
27617
27618 - `user_input: optional WebFetchURLSourceAll or WebFetchURLSourceNone`
27619
27620 Whether URLs in user messages are fetchable: "all" or "none".
27621
27622 - `WebFetchURLSourceAll object`
27623
27624 The `url_sources` variant under which a source contributes in
27625 full: every result of the tool filter's source, or all user input.
27626
27627 - `WebFetchURLSourceNone object`
27628
27629 The `url_sources` variant under which a source contributes nothing:
27630 no result of the tool filter's source, or no user input.
2664327631
2664427632### Web Search Result Block
2664527633
from line 30827
2983930827
2984030828 When true, guarantees schema validation on tool names and inputs
2984130829
30830 - `url_sources: optional WebFetchURLSources or null`
30831
30832 Which sources contribute to the set of URLs web fetch may fetch.
30833
30834 Each key is a tagged variant: `user_input` is `all` or `none`; the
30835 two tool filters are `all`, `none`, `only` (only the named tools'
30836 results) or `except` (every result but the named tools'). A named tool
30837 must be declared in this request's `tools[]`.
30838
30839 - `client_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
30840
30841 Which client tools' results contribute fetchable URLs: "all", "none", or an only or except list of client tool names from tools[].
30842
30843 - `WebFetchURLSourceAll object`
30844
30845 The `url_sources` variant under which a source contributes in
30846 full: every result of the tool filter's source, or all user input.
30847
30848 - `type: "all"`
30849
30850 - `WebFetchURLSourceNone object`
30851
30852 The `url_sources` variant under which a source contributes nothing:
30853 no result of the tool filter's source, or no user input.
30854
30855 - `type: "none"`
30856
30857 - `WebFetchURLSourceOnly object`
30858
30859 The tool filter variant under which only the named tools' results
30860 contribute.
30861
30862 - `type: "only"`
30863
30864 - `tools: array of WebFetchURLSourceToolReference`
30865
30866 - `type: "tool_reference"`
30867
30868 - `name: string`
30869
30870 - `WebFetchURLSourceExcept object`
30871
30872 The tool filter variant under which every result but the named
30873 tools' contributes.
30874
30875 - `type: "except"`
30876
30877 - `tools: array of WebFetchURLSourceToolReference`
30878
30879 - `type: "tool_reference"`
30880
30881 - `name: string`
30882
30883 - `server_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
30884
30885 Which server tools' results contribute fetchable URLs: "all", "none", or an only or except list of server tool names from tools[]; only web_search and web_fetch results ever contribute.
30886
30887 - `WebFetchURLSourceAll object`
30888
30889 The `url_sources` variant under which a source contributes in
30890 full: every result of the tool filter's source, or all user input.
30891
30892 - `WebFetchURLSourceNone object`
30893
30894 The `url_sources` variant under which a source contributes nothing:
30895 no result of the tool filter's source, or no user input.
30896
30897 - `WebFetchURLSourceOnly object`
30898
30899 The tool filter variant under which only the named tools' results
30900 contribute.
30901
30902 - `WebFetchURLSourceExcept object`
30903
30904 The tool filter variant under which every result but the named
30905 tools' contributes.
30906
30907 - `user_input: optional WebFetchURLSourceAll or WebFetchURLSourceNone`
30908
30909 Whether URLs in user messages are fetchable: "all" or "none".
30910
30911 - `WebFetchURLSourceAll object`
30912
30913 The `url_sources` variant under which a source contributes in
30914 full: every result of the tool filter's source, or all user input.
30915
30916 - `WebFetchURLSourceNone object`
30917
30918 The `url_sources` variant under which a source contributes nothing:
30919 no result of the tool filter's source, or no user input.
30920
2984230921 - `WebSearchTool20260209 object`
2984330922
2984430923 - `type: "web_search_20260209"`
from line 31024
2994531024
2994631025 When true, guarantees schema validation on tool names and inputs
2994731026
31027 - `url_sources: optional WebFetchURLSources or null`
31028
31029 Which sources contribute to the set of URLs web fetch may fetch.
31030
31031 Each key is a tagged variant: `user_input` is `all` or `none`; the
31032 two tool filters are `all`, `none`, `only` (only the named tools'
31033 results) or `except` (every result but the named tools'). A named tool
31034 must be declared in this request's `tools[]`.
31035
2994831036 - `WebFetchTool20260309 object`
2994931037
2995031038 Web fetch tool with use_cache parameter for bypassing cached content.
from line 31091
3000331091
3000431092 When true, guarantees schema validation on tool names and inputs
3000531093
31094 - `url_sources: optional WebFetchURLSources or null`
31095
31096 Which sources contribute to the set of URLs web fetch may fetch.
31097
31098 Each key is a tagged variant: `user_input` is `all` or `none`; the
31099 two tool filters are `all`, `none`, `only` (only the named tools'
31100 results) or `except` (every result but the named tools'). A named tool
31101 must be declared in this request's `tools[]`.
31102
3000631103 - `use_cache: optional boolean`
3000731104
3000831105 Whether to use cached content. Set to false to bypass the cache and fetch fresh content. Only set to false when the user explicitly requests fresh content or when fetching rapidly-changing sources.
from line 31225
3012831225 - `strict: optional boolean`
3012931226
3013031227 When true, guarantees schema validation on tool names and inputs
31228
31229 - `url_sources: optional WebFetchURLSources or null`
31230
31231 Which sources contribute to the set of URLs web fetch may fetch.
31232
31233 Each key is a tagged variant: `user_input` is `all` or `none`; the
31234 two tool filters are `all`, `none`, `only` (only the named tools'
31235 results) or `except` (every result but the named tools'). A named tool
31236 must be declared in this request's `tools[]`.
3013131237
3013231238 - `use_cache: optional boolean`
3013331239
3013431240
api/messages/batches Changed · +118 / -0 lines
from line 2583
25832583
25842584 When true, guarantees schema validation on tool names and inputs
25852585
2586 - `url_sources: optional WebFetchURLSources or null`
2587
2588 Which sources contribute to the set of URLs web fetch may fetch.
2589
2590 Each key is a tagged variant: `user_input` is `all` or `none`; the
2591 two tool filters are `all`, `none`, `only` (only the named tools'
2592 results) or `except` (every result but the named tools'). A named tool
2593 must be declared in this request's `tools[]`.
2594
2595 - `client_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
2596
2597 Which client tools' results contribute fetchable URLs: "all", "none", or an only or except list of client tool names from tools[].
2598
2599 - `WebFetchURLSourceAll object`
2600
2601 The `url_sources` variant under which a source contributes in
2602 full: every result of the tool filter's source, or all user input.
2603
2604 - `type: "all"`
2605
2606 - `WebFetchURLSourceNone object`
2607
2608 The `url_sources` variant under which a source contributes nothing:
2609 no result of the tool filter's source, or no user input.
2610
2611 - `type: "none"`
2612
2613 - `WebFetchURLSourceOnly object`
2614
2615 The tool filter variant under which only the named tools' results
2616 contribute.
2617
2618 - `type: "only"`
2619
2620 - `tools: array of WebFetchURLSourceToolReference`
2621
2622 - `type: "tool_reference"`
2623
2624 - `name: string`
2625
2626 - `WebFetchURLSourceExcept object`
2627
2628 The tool filter variant under which every result but the named
2629 tools' contributes.
2630
2631 - `type: "except"`
2632
2633 - `tools: array of WebFetchURLSourceToolReference`
2634
2635 - `type: "tool_reference"`
2636
2637 - `name: string`
2638
2639 - `server_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
2640
2641 Which server tools' results contribute fetchable URLs: "all", "none", or an only or except list of server tool names from tools[]; only web_search and web_fetch results ever contribute.
2642
2643 - `WebFetchURLSourceAll object`
2644
2645 The `url_sources` variant under which a source contributes in
2646 full: every result of the tool filter's source, or all user input.
2647
2648 - `WebFetchURLSourceNone object`
2649
2650 The `url_sources` variant under which a source contributes nothing:
2651 no result of the tool filter's source, or no user input.
2652
2653 - `WebFetchURLSourceOnly object`
2654
2655 The tool filter variant under which only the named tools' results
2656 contribute.
2657
2658 - `WebFetchURLSourceExcept object`
2659
2660 The tool filter variant under which every result but the named
2661 tools' contributes.
2662
2663 - `user_input: optional WebFetchURLSourceAll or WebFetchURLSourceNone`
2664
2665 Whether URLs in user messages are fetchable: "all" or "none".
2666
2667 - `WebFetchURLSourceAll object`
2668
2669 The `url_sources` variant under which a source contributes in
2670 full: every result of the tool filter's source, or all user input.
2671
2672 - `WebFetchURLSourceNone object`
2673
2674 The `url_sources` variant under which a source contributes nothing:
2675 no result of the tool filter's source, or no user input.
2676
25862677 - `WebSearchTool20260209 object`
25872678
25882679 - `type: "web_search_20260209"`
from line 2780
26892780
26902781 When true, guarantees schema validation on tool names and inputs
26912782
2783 - `url_sources: optional WebFetchURLSources or null`
2784
2785 Which sources contribute to the set of URLs web fetch may fetch.
2786
2787 Each key is a tagged variant: `user_input` is `all` or `none`; the
2788 two tool filters are `all`, `none`, `only` (only the named tools'
2789 results) or `except` (every result but the named tools'). A named tool
2790 must be declared in this request's `tools[]`.
2791
26922792 - `WebFetchTool20260309 object`
26932793
26942794 Web fetch tool with use_cache parameter for bypassing cached content.
from line 2847
27472847
27482848 When true, guarantees schema validation on tool names and inputs
27492849
2850 - `url_sources: optional WebFetchURLSources or null`
2851
2852 Which sources contribute to the set of URLs web fetch may fetch.
2853
2854 Each key is a tagged variant: `user_input` is `all` or `none`; the
2855 two tool filters are `all`, `none`, `only` (only the named tools'
2856 results) or `except` (every result but the named tools'). A named tool
2857 must be declared in this request's `tools[]`.
2858
27502859 - `use_cache: optional boolean`
27512860
27522861 Whether to use cached content. Set to false to bypass the cache and fetch fresh content. Only set to false when the user explicitly requests fresh content or when fetching rapidly-changing sources.
from line 2981
28722981 - `strict: optional boolean`
28732982
28742983 When true, guarantees schema validation on tool names and inputs
2984
2985 - `url_sources: optional WebFetchURLSources or null`
2986
2987 Which sources contribute to the set of URLs web fetch may fetch.
2988
2989 Each key is a tagged variant: `user_input` is `all` or `none`; the
2990 two tool filters are `all`, `none`, `only` (only the named tools'
2991 results) or `except` (every result but the named tools'). A named tool
2992 must be declared in this request's `tools[]`.
28752993
28762994 - `use_cache: optional boolean`
28772995
api/messages/batches/create Changed · +118 / -0 lines
from line 2581
25812581
25822582 When true, guarantees schema validation on tool names and inputs
25832583
2584 - `url_sources: optional WebFetchURLSources or null`
2585
2586 Which sources contribute to the set of URLs web fetch may fetch.
2587
2588 Each key is a tagged variant: `user_input` is `all` or `none`; the
2589 two tool filters are `all`, `none`, `only` (only the named tools'
2590 results) or `except` (every result but the named tools'). A named tool
2591 must be declared in this request's `tools[]`.
2592
2593 - `client_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
2594
2595 Which client tools' results contribute fetchable URLs: "all", "none", or an only or except list of client tool names from tools[].
2596
2597 - `WebFetchURLSourceAll object`
2598
2599 The `url_sources` variant under which a source contributes in
2600 full: every result of the tool filter's source, or all user input.
2601
2602 - `type: "all"`
2603
2604 - `WebFetchURLSourceNone object`
2605
2606 The `url_sources` variant under which a source contributes nothing:
2607 no result of the tool filter's source, or no user input.
2608
2609 - `type: "none"`
2610
2611 - `WebFetchURLSourceOnly object`
2612
2613 The tool filter variant under which only the named tools' results
2614 contribute.
2615
2616 - `type: "only"`
2617
2618 - `tools: array of WebFetchURLSourceToolReference`
2619
2620 - `type: "tool_reference"`
2621
2622 - `name: string`
2623
2624 - `WebFetchURLSourceExcept object`
2625
2626 The tool filter variant under which every result but the named
2627 tools' contributes.
2628
2629 - `type: "except"`
2630
2631 - `tools: array of WebFetchURLSourceToolReference`
2632
2633 - `type: "tool_reference"`
2634
2635 - `name: string`
2636
2637 - `server_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
2638
2639 Which server tools' results contribute fetchable URLs: "all", "none", or an only or except list of server tool names from tools[]; only web_search and web_fetch results ever contribute.
2640
2641 - `WebFetchURLSourceAll object`
2642
2643 The `url_sources` variant under which a source contributes in
2644 full: every result of the tool filter's source, or all user input.
2645
2646 - `WebFetchURLSourceNone object`
2647
2648 The `url_sources` variant under which a source contributes nothing:
2649 no result of the tool filter's source, or no user input.
2650
2651 - `WebFetchURLSourceOnly object`
2652
2653 The tool filter variant under which only the named tools' results
2654 contribute.
2655
2656 - `WebFetchURLSourceExcept object`
2657
2658 The tool filter variant under which every result but the named
2659 tools' contributes.
2660
2661 - `user_input: optional WebFetchURLSourceAll or WebFetchURLSourceNone`
2662
2663 Whether URLs in user messages are fetchable: "all" or "none".
2664
2665 - `WebFetchURLSourceAll object`
2666
2667 The `url_sources` variant under which a source contributes in
2668 full: every result of the tool filter's source, or all user input.
2669
2670 - `WebFetchURLSourceNone object`
2671
2672 The `url_sources` variant under which a source contributes nothing:
2673 no result of the tool filter's source, or no user input.
2674
25842675 - `WebSearchTool20260209 object`
25852676
25862677 - `type: "web_search_20260209"`
from line 2778
26872778
26882779 When true, guarantees schema validation on tool names and inputs
26892780
2781 - `url_sources: optional WebFetchURLSources or null`
2782
2783 Which sources contribute to the set of URLs web fetch may fetch.
2784
2785 Each key is a tagged variant: `user_input` is `all` or `none`; the
2786 two tool filters are `all`, `none`, `only` (only the named tools'
2787 results) or `except` (every result but the named tools'). A named tool
2788 must be declared in this request's `tools[]`.
2789
26902790 - `WebFetchTool20260309 object`
26912791
26922792 Web fetch tool with use_cache parameter for bypassing cached content.
from line 2845
27452845
27462846 When true, guarantees schema validation on tool names and inputs
27472847
2848 - `url_sources: optional WebFetchURLSources or null`
2849
2850 Which sources contribute to the set of URLs web fetch may fetch.
2851
2852 Each key is a tagged variant: `user_input` is `all` or `none`; the
2853 two tool filters are `all`, `none`, `only` (only the named tools'
2854 results) or `except` (every result but the named tools'). A named tool
2855 must be declared in this request's `tools[]`.
2856
27482857 - `use_cache: optional boolean`
27492858
27502859 Whether to use cached content. Set to false to bypass the cache and fetch fresh content. Only set to false when the user explicitly requests fresh content or when fetching rapidly-changing sources.
from line 2979
28702979 - `strict: optional boolean`
28712980
28722981 When true, guarantees schema validation on tool names and inputs
2982
2983 - `url_sources: optional WebFetchURLSources or null`
2984
2985 Which sources contribute to the set of URLs web fetch may fetch.
2986
2987 Each key is a tagged variant: `user_input` is `all` or `none`; the
2988 two tool filters are `all`, `none`, `only` (only the named tools'
2989 results) or `except` (every result but the named tools'). A named tool
2990 must be declared in this request's `tools[]`.
28732991
28742992 - `use_cache: optional boolean`
28752993
api/messages/count_tokens Changed · +118 / -0 lines
from line 2469
24692469
24702470 When true, guarantees schema validation on tool names and inputs
24712471
2472 - `url_sources: optional WebFetchURLSources or null`
2473
2474 Which sources contribute to the set of URLs web fetch may fetch.
2475
2476 Each key is a tagged variant: `user_input` is `all` or `none`; the
2477 two tool filters are `all`, `none`, `only` (only the named tools'
2478 results) or `except` (every result but the named tools'). A named tool
2479 must be declared in this request's `tools[]`.
2480
2481 - `client_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
2482
2483 Which client tools' results contribute fetchable URLs: "all", "none", or an only or except list of client tool names from tools[].
2484
2485 - `WebFetchURLSourceAll object`
2486
2487 The `url_sources` variant under which a source contributes in
2488 full: every result of the tool filter's source, or all user input.
2489
2490 - `type: "all"`
2491
2492 - `WebFetchURLSourceNone object`
2493
2494 The `url_sources` variant under which a source contributes nothing:
2495 no result of the tool filter's source, or no user input.
2496
2497 - `type: "none"`
2498
2499 - `WebFetchURLSourceOnly object`
2500
2501 The tool filter variant under which only the named tools' results
2502 contribute.
2503
2504 - `type: "only"`
2505
2506 - `tools: array of WebFetchURLSourceToolReference`
2507
2508 - `type: "tool_reference"`
2509
2510 - `name: string`
2511
2512 - `WebFetchURLSourceExcept object`
2513
2514 The tool filter variant under which every result but the named
2515 tools' contributes.
2516
2517 - `type: "except"`
2518
2519 - `tools: array of WebFetchURLSourceToolReference`
2520
2521 - `type: "tool_reference"`
2522
2523 - `name: string`
2524
2525 - `server_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
2526
2527 Which server tools' results contribute fetchable URLs: "all", "none", or an only or except list of server tool names from tools[]; only web_search and web_fetch results ever contribute.
2528
2529 - `WebFetchURLSourceAll object`
2530
2531 The `url_sources` variant under which a source contributes in
2532 full: every result of the tool filter's source, or all user input.
2533
2534 - `WebFetchURLSourceNone object`
2535
2536 The `url_sources` variant under which a source contributes nothing:
2537 no result of the tool filter's source, or no user input.
2538
2539 - `WebFetchURLSourceOnly object`
2540
2541 The tool filter variant under which only the named tools' results
2542 contribute.
2543
2544 - `WebFetchURLSourceExcept object`
2545
2546 The tool filter variant under which every result but the named
2547 tools' contributes.
2548
2549 - `user_input: optional WebFetchURLSourceAll or WebFetchURLSourceNone`
2550
2551 Whether URLs in user messages are fetchable: "all" or "none".
2552
2553 - `WebFetchURLSourceAll object`
2554
2555 The `url_sources` variant under which a source contributes in
2556 full: every result of the tool filter's source, or all user input.
2557
2558 - `WebFetchURLSourceNone object`
2559
2560 The `url_sources` variant under which a source contributes nothing:
2561 no result of the tool filter's source, or no user input.
2562
24722563 - `WebSearchTool20260209 object`
24732564
24742565 - `type: "web_search_20260209"`
from line 2666
25752666
25762667 When true, guarantees schema validation on tool names and inputs
25772668
2669 - `url_sources: optional WebFetchURLSources or null`
2670
2671 Which sources contribute to the set of URLs web fetch may fetch.
2672
2673 Each key is a tagged variant: `user_input` is `all` or `none`; the
2674 two tool filters are `all`, `none`, `only` (only the named tools'
2675 results) or `except` (every result but the named tools'). A named tool
2676 must be declared in this request's `tools[]`.
2677
25782678 - `WebFetchTool20260309 object`
25792679
25802680 Web fetch tool with use_cache parameter for bypassing cached content.
from line 2733
26332733
26342734 When true, guarantees schema validation on tool names and inputs
26352735
2736 - `url_sources: optional WebFetchURLSources or null`
2737
2738 Which sources contribute to the set of URLs web fetch may fetch.
2739
2740 Each key is a tagged variant: `user_input` is `all` or `none`; the
2741 two tool filters are `all`, `none`, `only` (only the named tools'
2742 results) or `except` (every result but the named tools'). A named tool
2743 must be declared in this request's `tools[]`.
2744
26362745 - `use_cache: optional boolean`
26372746
26382747 Whether to use cached content. Set to false to bypass the cache and fetch fresh content. Only set to false when the user explicitly requests fresh content or when fetching rapidly-changing sources.
from line 2867
27582867 - `strict: optional boolean`
27592868
27602869 When true, guarantees schema validation on tool names and inputs
2870
2871 - `url_sources: optional WebFetchURLSources or null`
2872
2873 Which sources contribute to the set of URLs web fetch may fetch.
2874
2875 Each key is a tagged variant: `user_input` is `all` or `none`; the
2876 two tool filters are `all`, `none`, `only` (only the named tools'
2877 results) or `except` (every result but the named tools'). A named tool
2878 must be declared in this request's `tools[]`.
27612879
27622880 - `use_cache: optional boolean`
27632881
api/messages/create Changed · +118 / -0 lines
from line 2561
25612561
25622562 When true, guarantees schema validation on tool names and inputs
25632563
2564 - `url_sources: optional WebFetchURLSources or null`
2565
2566 Which sources contribute to the set of URLs web fetch may fetch.
2567
2568 Each key is a tagged variant: `user_input` is `all` or `none`; the
2569 two tool filters are `all`, `none`, `only` (only the named tools'
2570 results) or `except` (every result but the named tools'). A named tool
2571 must be declared in this request's `tools[]`.
2572
2573 - `client_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
2574
2575 Which client tools' results contribute fetchable URLs: "all", "none", or an only or except list of client tool names from tools[].
2576
2577 - `WebFetchURLSourceAll object`
2578
2579 The `url_sources` variant under which a source contributes in
2580 full: every result of the tool filter's source, or all user input.
2581
2582 - `type: "all"`
2583
2584 - `WebFetchURLSourceNone object`
2585
2586 The `url_sources` variant under which a source contributes nothing:
2587 no result of the tool filter's source, or no user input.
2588
2589 - `type: "none"`
2590
2591 - `WebFetchURLSourceOnly object`
2592
2593 The tool filter variant under which only the named tools' results
2594 contribute.
2595
2596 - `type: "only"`
2597
2598 - `tools: array of WebFetchURLSourceToolReference`
2599
2600 - `type: "tool_reference"`
2601
2602 - `name: string`
2603
2604 - `WebFetchURLSourceExcept object`
2605
2606 The tool filter variant under which every result but the named
2607 tools' contributes.
2608
2609 - `type: "except"`
2610
2611 - `tools: array of WebFetchURLSourceToolReference`
2612
2613 - `type: "tool_reference"`
2614
2615 - `name: string`
2616
2617 - `server_tool_results: optional WebFetchURLSourceAll or WebFetchURLSourceNone or WebFetchURLSourceOnly or WebFetchURLSourceExcept`
2618
2619 Which server tools' results contribute fetchable URLs: "all", "none", or an only or except list of server tool names from tools[]; only web_search and web_fetch results ever contribute.
2620
2621 - `WebFetchURLSourceAll object`
2622
2623 The `url_sources` variant under which a source contributes in
2624 full: every result of the tool filter's source, or all user input.
2625
2626 - `WebFetchURLSourceNone object`
2627
2628 The `url_sources` variant under which a source contributes nothing:
2629 no result of the tool filter's source, or no user input.
2630
2631 - `WebFetchURLSourceOnly object`
2632
2633 The tool filter variant under which only the named tools' results
2634 contribute.
2635
2636 - `WebFetchURLSourceExcept object`
2637
2638 The tool filter variant under which every result but the named
2639 tools' contributes.
2640
2641 - `user_input: optional WebFetchURLSourceAll or WebFetchURLSourceNone`
2642
2643 Whether URLs in user messages are fetchable: "all" or "none".
2644
2645 - `WebFetchURLSourceAll object`
2646
2647 The `url_sources` variant under which a source contributes in
2648 full: every result of the tool filter's source, or all user input.
2649
2650 - `WebFetchURLSourceNone object`
2651
2652 The `url_sources` variant under which a source contributes nothing:
2653 no result of the tool filter's source, or no user input.
2654
25642655 - `WebSearchTool20260209 object`
25652656
25662657 - `type: "web_search_20260209"`
from line 2758
26672758
26682759 When true, guarantees schema validation on tool names and inputs
26692760
2761 - `url_sources: optional WebFetchURLSources or null`
2762
2763 Which sources contribute to the set of URLs web fetch may fetch.
2764
2765 Each key is a tagged variant: `user_input` is `all` or `none`; the
2766 two tool filters are `all`, `none`, `only` (only the named tools'
2767 results) or `except` (every result but the named tools'). A named tool
2768 must be declared in this request's `tools[]`.
2769
26702770 - `WebFetchTool20260309 object`
26712771
26722772 Web fetch tool with use_cache parameter for bypassing cached content.
from line 2825
27252825
27262826 When true, guarantees schema validation on tool names and inputs
27272827
2828 - `url_sources: optional WebFetchURLSources or null`
2829
2830 Which sources contribute to the set of URLs web fetch may fetch.
2831
2832 Each key is a tagged variant: `user_input` is `all` or `none`; the
2833 two tool filters are `all`, `none`, `only` (only the named tools'
2834 results) or `except` (every result but the named tools'). A named tool
2835 must be declared in this request's `tools[]`.
2836
27282837 - `use_cache: optional boolean`
27292838
27302839 Whether to use cached content. Set to false to bypass the cache and fetch fresh content. Only set to false when the user explicitly requests fresh content or when fetching rapidly-changing sources.
from line 2959
28502959 - `strict: optional boolean`
28512960
28522961 When true, guarantees schema validation on tool names and inputs
2962
2963 - `url_sources: optional WebFetchURLSources or null`
2964
2965 Which sources contribute to the set of URLs web fetch may fetch.
2966
2967 Each key is a tagged variant: `user_input` is `all` or `none`; the
2968 two tool filters are `all`, `none`, `only` (only the named tools'
2969 results) or `except` (every result but the named tools'). A named tool
2970 must be declared in this request's `tools[]`.
28532971
28542972 - `use_cache: optional boolean`
28552973
api/models Changed · +6 / -2 lines
from line 39
3939
4040 - `string`
4141
42 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
42 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`
4343
4444 - `"message-batches-2024-09-24"`
4545
from line 131
131131
132132 - `"mid-conversation-system-clear-at-2026-08-21"`
133133
134 - `"compact-2026-09-04"`
135
134136- `"anthropic-workspace-id": optional string`
135137
136138### Returns
from line 392
390392
391393 - `string`
392394
393 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
395 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`
394396
395397 - `"message-batches-2024-09-24"`
396398
from line 483
481483 - `"thinking-binding-controls-2026-08-01"`
482484
483485 - `"mid-conversation-system-clear-at-2026-08-21"`
486
487 - `"compact-2026-09-04"`
484488
485489- `"anthropic-workspace-id": optional string`
486490
build-with-claude/batch-processing Changed · +3 / -3 lines
from line 529
529529 var messageBatch *anthropic.MessageBatch
530530 for {
531531 var err error
532 messageBatch, err = client.Messages.Batches.Get(context.TODO(), messageBatchID)
532 messageBatch, err = client.Messages.Batches.Get(context.TODO(), messageBatchID, anthropic.MessageBatchGetParams{})
533533 if err != nil {
534534 log.Fatal(err)
535535 }
from line 822
822822 ```go Go
823823 client := anthropic.NewClient()
824824
825 stream := client.Messages.Batches.ResultsStreaming(context.TODO(), "msgbatch_01HkcTjaV5uDC8jWR4ZsDV8d")
825 stream := client.Messages.Batches.ResultsStreaming(context.TODO(), "msgbatch_01HkcTjaV5uDC8jWR4ZsDV8d", anthropic.MessageBatchResultsParams{})
826826
827827 for stream.Next() {
828828 result := stream.Current()
from line 986
986986 client := anthropic.NewClient()
987987 messageBatchID := os.Getenv("MESSAGE_BATCH_ID")
988988
989 messageBatch, err := client.Messages.Batches.Cancel(context.TODO(), messageBatchID)
989 messageBatch, err := client.Messages.Batches.Cancel(context.TODO(), messageBatchID, anthropic.MessageBatchCancelParams{})
990990 if err != nil {
991991 log.Fatal(err)
992992 }
build-with-claude/files Changed · +3 / -3 lines
from line 783
783783 ```
784784
785785 ```go Go
786 metadata, err := client.Files.GetMetadata(context.TODO(), fileID)
786 metadata, err := client.Files.GetMetadata(context.TODO(), fileID, anthropic.FileGetMetadataParams{})
787787 if err != nil {
788788 log.Fatal(err)
789789 }
from line 837
837837 ```
838838
839839 ```go Go
840 _, err = client.Files.Delete(context.TODO(), fileID)
840 _, err = client.Files.Delete(context.TODO(), fileID, anthropic.FileDeleteParams{})
841841 if err != nil {
842842 log.Fatal(err)
843843 }
from line 896
896896
897897 ```go Go
898898 func downloadFile(client anthropic.Client, fileID string) error {
899 resp, err := client.Files.Download(context.TODO(), fileID)
899 resp, err := client.Files.Download(context.TODO(), fileID, anthropic.FileDownloadParams{})
900900 if err != nil {
901901 return err
902902 }
build-with-claude/prompt-caching Changed · +4 / -4 lines
from line 232
232232Prompt caching introduces a new pricing structure. The following table shows the price per million tokens for each supported model:
233233
234234| Model | Base input tokens | 5m cache writes | 1h cache writes | Cache hits and refreshes | Output tokens |
235| ------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | --------------- | --------------- | ------------------------ | ------------- |
236| Claude Fable 5.1 | $10 / MTok | $12.50 / MTok | $20 / MTok | $0.25 / MTok1 | $50 / MTok |
237| Claude Mythos 5.1 ([limited availability](https://anthropic.com/glasswing)) | $10 / MTok | $12.50 / MTok | $20 / MTok | $0.25 / MTok1 | $50 / MTok |
235| :------------------------------------------------------------------------------------------------------------------------------------ | :---------------- | :-------------- | :-------------- | :----------------------- | :------------ |
236| Claude Fable 5.1 | $10 / MTok | $12.50 / MTok | $20 / MTok | $0.25 / MTok<sup>1</sup> | $50 / MTok |
237| Claude Mythos 5.1 ([limited availability](https://anthropic.com/glasswing)) | $10 / MTok | $12.50 / MTok | $20 / MTok | $0.25 / MTok<sup>1</sup> | $50 / MTok |
238238| Claude Fable 5 | $10 / MTok | $12.50 / MTok | $20 / MTok | $1 / MTok | $50 / MTok |
239239| Claude Mythos 5 ([limited availability](https://anthropic.com/glasswing)) | $10 / MTok | $12.50 / MTok | $20 / MTok | $1 / MTok | $50 / MTok |
240240| Claude Opus 5 | $5 / MTok | $6.25 / MTok | $10 / MTok | $0.50 / MTok | $25 / MTok |
from line 251
251251| Claude Haiku 4.5 | $1 / MTok | $1.25 / MTok | $2 / MTok | $0.10 / MTok | $5 / MTok |
252252| Claude Haiku 3.5 ([retired, except on Bedrock and Google Cloud](https://platform.claude.com/docs/en/about-claude/model-deprecations)) | $0.80 / MTok | $1 / MTok | $1.60 / MTok | $0.08 / MTok | $4 / MTok |
253253
254*1 Cache hits and refreshes on Claude Fable 5.1 and Claude Mythos 5.1 are priced at 0.025x the base input price. All other models use the standard 0.1x multiplier.*
254*<sup>1 Cache hits and refreshes on Claude Fable 5.1 and Claude Mythos 5.1 are priced at 0.025x the base input price. All other models use the standard 0.1x multiplier.</sup>*
255255
256256<Note>
257257 The previous table reflects the following pricing multipliers for prompt caching:
build-with-claude/skills-guide Changed · +6 / -4 lines
from line 566
566566
567567 // Step 3: Download the file using Files API
568568 for _, fileID := range fileIDs {
569 fileMetadata, err := client.Files.GetMetadata(context.TODO(), fileID)
569 fileMetadata, err := client.Files.GetMetadata(context.TODO(), fileID, anthropic.FileGetMetadataParams{})
570570 if err != nil {
571571 log.Fatal(err)
572572 }
573573
574 fileContent, err := client.Files.Download(context.TODO(), fileID)
574 fileContent, err := client.Files.Download(context.TODO(), fileID, anthropic.FileDownloadParams{})
575575 if err != nil {
576576 log.Fatal(err)
577577 }
from line 847
847847 fileID := "file_011CNha8iCJcU1wXNR6q4V8w"
848848
849849 // Get file metadata
850 fileInfo, err := client.Files.GetMetadata(context.TODO(), fileID)
850 fileInfo, err := client.Files.GetMetadata(context.TODO(), fileID, anthropic.FileGetMetadataParams{})
851851 if err != nil {
852852 log.Fatal(err)
853853 }
from line 864
864864 }
865865
866866 // Delete a file
867 _, err = client.Files.Delete(context.TODO(), fileID)
867 _, err = client.Files.Delete(context.TODO(), fileID, anthropic.FileDeleteParams{})
868868 if err != nil {
869869 log.Fatal(err)
870870 }
from line 2664
26642664 skill, err := client.Skills.Get(
26652665 context.TODO(),
26662666 "skill_01AbCdEfGhIjKlMnOpQrStUv",
2667 anthropic.SkillGetParams{},
26672668 )
26682669 if err != nil {
26692670 log.Fatal(err)
from line 2749
27482749 _, err := client.Skills.Delete(
27492750 context.TODO(),
27502751 "skill_01AbCdEfGhIjKlMnOpQrStUv",
2752 anthropic.SkillDeleteParams{},
27512753 )
27522754 if err != nil {
27532755 log.Fatal(err)
cli-sdks-libraries/cli/sessions-connect New page · 47 lines, new page
## Connect to a session ## Follow and steer the session ## Open the session viewer in your browser
A whole new page. There's nothing to diff it against, so here is what it says.
--- title: Connect to a Managed Agents session from your terminal url: https://platform.claude.com/docs/en/cli-sdks-libraries/cli/sessions-connect description: Attach the ant CLI to a Claude Managed Agents session to follow its transcript live, send messages, allow or deny tool calls, or open the session viewer in your browser. --- `ant beta:sessions connect` attaches your terminal to an existing Claude Managed Agents [session](https://platform.claude.com/docs/en/managed-agents/sessions). It loads the session's transcript and follows it live as the agent works. You can also step in: send a message, interrupt the agent, or allow or deny a tool call that is waiting for approval. With `--web`, it opens the session in the Claude Console's session viewer in your browser instead. The command requires version 1.32.0 or later of the CLI. To install or update the CLI and authenticate, see the [CLI quickstart](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/quickstart). ## Connect to a session Pass the ID of a session in your workspace. You can copy it from the create response, from `ant beta:sessions list`, or from the Console. ```bash CLI ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7 ``` Without `--web`, the command needs an interactive terminal. In scripts, use `ant beta:sessions:events stream` and `ant beta:sessions:events send` instead. See [CLI scripting and automation](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/scripting). Press Ctrl+C to detach. The session keeps running, and connecting again loads its full history. ## Follow and steer the session The terminal view shows the conversation live: messages and tool calls, with each call's duration and outcome. A status bar shows whether the session is running, idle, or waiting for your approval. In [multiagent](https://platform.claude.com/docs/en/managed-agents/multiagent-orchestration) sessions, the view follows the session's primary thread, which includes the messages the coordinator exchanges with the agents it delegates to. | Key | Action | | ------------------ | -------------------------------------------------------------------------------------------------------------------------- | | Enter | Send your input as a `user.message` event. Alt+Enter or Ctrl+J starts a new line. | | Esc | Interrupt the agent while it's running (`user.interrupt`). | | Ctrl+O | Show or hide detail: tool inputs and results, token usage, and status events. `--verbose` (`-v`) starts with detail shown. | | Page Up, Page Down | Scroll through the transcript. Scrolling up pauses following; End resumes it. | | Ctrl+C | Detach. Ctrl+D on an empty input line also detaches. | When a tool call is waiting for your approval, the input line changes to **Allow tool call?** This happens under an `always_ask` policy, or under `auto` when the server reaches no determination. Choose **Yes**, **No**, or **No, and tell the agent why**. The CLI sends your choice as a [`user.tool_confirmation`](https://platform.claude.com/docs/en/managed-agents/permission-policies#respond-to-confirmation-requests) event, with any reason you type as its `deny_message`. If the session is `terminated` or deleted, the view is read-only. ## Open the session viewer in your browser ```bash CLI ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7 --web ``` `--web` serves the Console's session viewer from a local server on `127.0.0.1`, prints its URL, and opens it in your browser. Add `--no-browser` to skip opening the browser. You can also send messages, interrupt the agent, and allow or deny a tool call from the browser. Unlike the terminal view, the browser viewer follows every thread of a multiagent session. The URL can be opened once, within two minutes of being printed. Reloading that tab works, but to open the viewer anywhere else, run the command again. Your credentials never leave the CLI: the page sends requests only to the local `ant` process, which makes the API requests. The server runs until you press Ctrl+C.
managed-agents/agent-setup Changed · +4 / -4 lines
## Compatibility
from line 4
44description: Create a reusable, versioned agent configuration.
55---
66
7## Compatibility
8- Status: Beta
9- [Beta header](https://platform.claude.com/docs/en/api/beta-headers): `managed-agents-2026-04-01`
10
711An agent is a reusable, versioned configuration that defines persona and capabilities. It bundles the model, system prompt, tools, MCP servers, and skills that shape how Claude behaves during a session.
812
913Create the agent once as a reusable resource and reference it by ID each time you [start a session](https://platform.claude.com/docs/en/managed-agents/sessions). Agents are versioned and easier to manage across many sessions.
10
11<Note>
12 Managed Agents API requests require the `managed-agents-2026-04-01` beta header, except memory store endpoints, which use `agent-memory-2026-07-22` instead. The SDK sets the correct beta header automatically. See [Beta headers](https://platform.claude.com/docs/en/api/beta-headers#endpoint-specific-headers).
13</Note>
1414
1515## Agent configuration fields
1616
managed-agents/budgets Changed · +4 / -4 lines
## Compatibility
from line 4
44description: Cap a session's spend with a hard dollar budget enforced at public list rates.
55---
66
7A session budget is an optional hard spend ceiling you set when you [create a session](https://platform.claude.com/docs/en/managed-agents/sessions). The platform continuously prices everything the session consumes at public list rates (the session's **list cost**) and stops issuing new model requests once that cost reaches the budget. The request in flight when the cap is crossed still finishes, so the final list cost can land [a fraction past the budget](https://platform.claude.com/docs/en/managed-agents/budgets#when-a-session-reaches-its-budget). A session at its budget pauses and goes [idle](https://platform.claude.com/docs/en/managed-agents/session-operations#session-statuses) rather than terminating; changing or removing the budget resumes its work automatically. Deployments accept the same budget and apply it to each session they start; see [Budgets on deployments](https://platform.claude.com/docs/en/managed-agents/budgets#budgets-on-deployments).
7## Compatibility
8- Status: Beta
9- [Beta header](https://platform.claude.com/docs/en/api/beta-headers): `managed-agents-2026-04-01`
810
9<Note>
10 Managed Agents API requests require the `managed-agents-2026-04-01` beta header, except memory store endpoints, which use `agent-memory-2026-07-22` instead. The SDK sets the correct beta header automatically. See [Beta headers](https://platform.claude.com/docs/en/api/beta-headers#endpoint-specific-headers).
11</Note>
11A session budget is an optional hard spend ceiling you set when you [create a session](https://platform.claude.com/docs/en/managed-agents/sessions). The platform continuously prices everything the session consumes at public list rates (the session's **list cost**) and stops issuing new model requests once that cost reaches the budget. The request in flight when the cap is crossed still finishes, so the final list cost can land [a fraction past the budget](https://platform.claude.com/docs/en/managed-agents/budgets#when-a-session-reaches-its-budget). A session at its budget pauses and goes [idle](https://platform.claude.com/docs/en/managed-agents/session-operations#session-statuses) rather than terminating; changing or removing the budget resumes its work automatically. Deployments accept the same budget and apply it to each session they start; see [Budgets on deployments](https://platform.claude.com/docs/en/managed-agents/budgets#budgets-on-deployments).
1212
1313## Set a budget at session creation
1414
managed-agents/cloud-sandboxes-reference Changed · +4 / -4 lines
## Compatibility
from line 4
44description: Pre-installed packages, databases, and utilities available in cloud sandboxes.
55---
66
7## Compatibility
8- Status: Beta
9- [Beta header](https://platform.claude.com/docs/en/api/beta-headers): `managed-agents-2026-04-01`
10
711Cloud sandboxes run as isolated Linux containers on Anthropic-managed infrastructure. They come pre-installed with a comprehensive set of programming languages, databases, and utilities. The agent can use these immediately without any installation steps.
812
913These specifications apply to `cloud` environments. Self-hosted sandboxes run on your infrastructure with whatever your worker provides.
10
11<Note>
12 Managed Agents API requests require the `managed-agents-2026-04-01` beta header, except memory store endpoints, which use `agent-memory-2026-07-22` instead. The SDK sets the correct beta header automatically. See [Beta headers](https://platform.claude.com/docs/en/api/beta-headers#endpoint-specific-headers).
13</Note>
1414
1515## Programming languages
1616
managed-agents/define-outcomes Changed · +5 / -5 lines
## Compatibility
from line 4
44description: Tell the agent what 'done' looks like, and let it iterate until it gets there.
55---
66
7## Compatibility
8- Status: Beta
9- [Beta header](https://platform.claude.com/docs/en/api/beta-headers): `managed-agents-2026-04-01`
10
711An outcome tells the session what the end result should look like and how to measure its quality. The agent works toward that target, self-evaluating and iterating until the outcome is met.
812
913When you define an outcome, the harness automatically provisions a *grader* to evaluate the artifact against a rubric. The grader uses a separate context window to avoid being influenced by the main agent's implementation choices.
from line 14
1014
1115The grader returns an explanation summarizing which criteria passed or failed, or confirming that the artifact satisfies the rubric. That feedback is handed back to the agent for the next iteration.
1216
13<Note>
14 Managed Agents API requests require the `managed-agents-2026-04-01` beta header, except memory store endpoints, which use `agent-memory-2026-07-22` instead. The SDK sets the correct beta header automatically. See [Beta headers](https://platform.claude.com/docs/en/api/beta-headers#endpoint-specific-headers).
15</Note>
16
1717## Create a rubric
1818
1919A rubric is a markdown document describing per-criterion scoring. The rubric is required.
from line 816
816816
817817 // Download a file
818818 if len(files.Data) > 0 {
819 resp, err := client.Files.Download(ctx, files.Data[0].ID)
819 resp, err := client.Files.Download(ctx, files.Data[0].ID, anthropic.FileDownloadParams{})
820820 if err != nil {
821821 panic(err)
822822 }
managed-agents/environments Changed · +4 / -4 lines
## Compatibility
from line 4
44description: Customize cloud sandboxes for your sessions.
55---
66
7## Compatibility
8- Status: Beta
9- [Beta header](https://platform.claude.com/docs/en/api/beta-headers): `managed-agents-2026-04-01`
10
711Environments define the sandbox configuration where your agent runs. You create an environment once, then reference its ID each time you start a session. Multiple sessions can share the same environment, but each session gets its own isolated sandbox (a fresh Linux container).
812
913This page covers `type: cloud` environments. To run sandboxes on your own infrastructure, see [Self-hosted sandboxes](https://platform.claude.com/docs/en/managed-agents/self-hosted-sandboxes).
10
11<Note>
12 Managed Agents API requests require the `managed-agents-2026-04-01` beta header, except memory store endpoints, which use `agent-memory-2026-07-22` instead. The SDK sets the correct beta header automatically. See [Beta headers](https://platform.claude.com/docs/en/api/beta-headers#endpoint-specific-headers).
13</Note>
1414
1515## Create an environment
1616
managed-agents/events-and-streaming Changed · +4 / -4 lines
## Compatibility
from line 4
44description: Send events, stream responses, and interrupt or redirect your session mid-execution.
55---
66
7Communication with Claude Managed Agents is event-based. You send user events to the agent, and receive agent and session events back to track status.
7## Compatibility
8- Status: Beta
9- [Beta header](https://platform.claude.com/docs/en/api/beta-headers): `managed-agents-2026-04-01`
810
9<Note>
10 Managed Agents API requests require the `managed-agents-2026-04-01` beta header, except memory store endpoints, which use `agent-memory-2026-07-22` instead. The SDK sets the correct beta header automatically. See [Beta headers](https://platform.claude.com/docs/en/api/beta-headers#endpoint-specific-headers).
11</Note>
11Communication with Claude Managed Agents is event-based. You send user events to the agent, and receive agent and session events back to track status.
1212
1313## Event types
1414
managed-agents/files Changed · +5 / -5 lines
## Compatibility
from line 4
44description: Upload files and mount them in your sandbox for reading and processing.
55---
66
7## Compatibility
8- Status: Beta
9- [Beta header](https://platform.claude.com/docs/en/api/beta-headers): `managed-agents-2026-04-01`
10
711You can provide files to your agent by uploading them through the Files API and mounting them in the session's sandbox.
812
9<Note>
10 Managed Agents API requests require the `managed-agents-2026-04-01` beta header, except memory store endpoints, which use `agent-memory-2026-07-22` instead. The SDK sets the correct beta header automatically. See [Beta headers](https://platform.claude.com/docs/en/api/beta-headers#endpoint-specific-headers).
11</Note>
12
1313## Uploading files
1414
1515First, upload a file using the [Files API](https://platform.claude.com/docs/en/build-with-claude/files):
from line 649
649649 }
650650
651651 // Download a file
652 resp, err := client.Files.Download(ctx, files.Data[0].ID)
652 resp, err := client.Files.Download(ctx, files.Data[0].ID, anthropic.FileDownloadParams{})
653653 if err != nil {
654654 panic(err)
655655 }
managed-agents/github Changed · +4 / -4 lines
## Compatibility
from line 4
44description: Connect your agent to GitHub repositories for cloning, reading, and creating pull requests.
55---
66
7## Compatibility
8- Status: Beta
9- [Beta header](https://platform.claude.com/docs/en/api/beta-headers): `managed-agents-2026-04-01`
10
711You can mount a GitHub repository to your session sandbox and connect to the GitHub MCP for making pull requests.
812
913GitHub repositories are cached, so future sessions that use the same repository start faster.
10
11<Note>
12 Managed Agents API requests require the `managed-agents-2026-04-01` beta header, except memory store endpoints, which use `agent-memory-2026-07-22` instead. The SDK sets the correct beta header automatically. See [Beta headers](https://platform.claude.com/docs/en/api/beta-headers#endpoint-specific-headers).
13</Note>
1414
1515## GitHub MCP and session resources
1616
managed-agents/mcp-connector Changed · +4 / -4 lines
## Compatibility
from line 4
44description: Connect MCP servers to your agents for access to external tools and data sources.
55---
66
7## Compatibility
8- Status: Beta
9- [Beta header](https://platform.claude.com/docs/en/api/beta-headers): `managed-agents-2026-04-01`
10
711Claude Managed Agents supports connecting [Model Context Protocol (MCP)](https://modelcontextprotocol.io) servers to your agents. This gives the agent access to external tools, data sources, and services through a standardized protocol.
812
913MCP configuration is split across two steps:
from line 16
12162. **Session creation** supplies authentication for those servers by referencing a pre-registered vault (see [Authenticate with vaults](https://platform.claude.com/docs/en/managed-agents/vaults)).
1317
1418This separation keeps secrets out of reusable agent definitions while letting each session authenticate with its own credentials.
15
16<Note>
17 Managed Agents API requests require the `managed-agents-2026-04-01` beta header, except memory store endpoints, which use `agent-memory-2026-07-22` instead. The SDK sets the correct beta header automatically. See [Beta headers](https://platform.claude.com/docs/en/api/beta-headers#endpoint-specific-headers).
18</Note>
1919
2020## Declare MCP servers on the agent
2121
managed-agents/memory Changed · +4 / -4 lines
## Compatibility
from line 4
44description: Give your agents persistent memory that survives across sessions using memory stores.
55---
66
7Each Managed Agents session starts with a fresh context by default. When a session ends, any state the agent built up is gone. Memory stores let the agent carry information across sessions: user preferences, project conventions, prior mistakes, and domain context.
7## Compatibility
8- Status: Beta
9- [Beta header](https://platform.claude.com/docs/en/api/beta-headers): `agent-memory-2026-07-22`
810
9<Note>
10 Managed Agents API requests require the `managed-agents-2026-04-01` beta header, except memory store endpoints, which use `agent-memory-2026-07-22` instead. The SDK sets the correct beta header automatically. See [Beta headers](https://platform.claude.com/docs/en/api/beta-headers#endpoint-specific-headers).
11</Note>
11Each Managed Agents session starts with a fresh context by default. When a session ends, any state the agent built up is gone. Memory stores let the agent carry information across sessions: user preferences, project conventions, prior mistakes, and domain context.
1212
1313<Note>
1414 Don't combine `agent-memory-2026-07-22` with `managed-agents-2026-04-01` on a memory store request: sending both returns a `400` error. If your code sets beta headers explicitly, replace `managed-agents-2026-04-01` with `agent-memory-2026-07-22` on memory store calls rather than adding a second value. Session endpoints, including attaching a memory store to a session, still use `managed-agents-2026-04-01`.
managed-agents/migration Changed · +4 / -4 lines
## Compatibility
from line 4
44description: Move an existing agent built on the Messages API or the Claude Agent SDK to Claude Managed Agents.
55---
66
7Claude Managed Agents replaces your hand-written agent loop with managed infrastructure. This page covers what changes when you migrate from a custom loop built on the [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) or from the [Claude Agent SDK](https://code.claude.com/docs/en/agent-sdk/overview).
7## Compatibility
8- Status: Beta
9- [Beta header](https://platform.claude.com/docs/en/api/beta-headers): `managed-agents-2026-04-01`
810
9<Note>
10 Managed Agents API requests require the `managed-agents-2026-04-01` beta header, except memory store endpoints, which use `agent-memory-2026-07-22` instead. The SDK sets the correct beta header automatically. See [Beta headers](https://platform.claude.com/docs/en/api/beta-headers#endpoint-specific-headers).
11</Note>
11Claude Managed Agents replaces your hand-written agent loop with managed infrastructure. This page covers what changes when you migrate from a custom loop built on the [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) or from the [Claude Agent SDK](https://code.claude.com/docs/en/agent-sdk/overview).
1212
1313## From a Messages API agent loop
1414
managed-agents/multiagent-orchestration Changed · +4 / -4 lines
## Compatibility
from line 4
44description: Coordinate multiple agents within a single session.
55---
66
7## Compatibility
8- Status: Beta
9- [Beta header](https://platform.claude.com/docs/en/api/beta-headers): `managed-agents-2026-04-01`
10
711Multiagent orchestration lets one agent coordinate with others to complete complex work. Agents can act in parallel with their own isolated context, which helps improve output quality and can also improve time to completion.
812
913Not sure a multiagent setup fits your problem? See [when to use multiagent systems (and when not to)](https://claude.com/blog/building-multi-agent-systems-when-and-how-to-use-them).
10
11<Note>
12 Managed Agents API requests require the `managed-agents-2026-04-01` beta header, except memory store endpoints, which use `agent-memory-2026-07-22` instead. The SDK sets the correct beta header automatically. See [Beta headers](https://platform.claude.com/docs/en/api/beta-headers#endpoint-specific-headers).
13</Note>
1414
1515## How it works
1616
managed-agents/onboarding Changed · +4 / -4 lines
## Compatibility
from line 4
44description: Create, test, and iterate on agents visually in Console, then run them from your code with the API.
55---
66
7[Console](https://platform.claude.com/workspaces/default/agent-quickstart/) provides a visual interface for creating and configuring agents. It lets you iterate on configuration interactively before writing code.
7## Compatibility
8- Status: Beta
9- [Beta header](https://platform.claude.com/docs/en/api/beta-headers): `managed-agents-2026-04-01`
810
9<Note>
10 Managed Agents API requests require the `managed-agents-2026-04-01` beta header, except memory store endpoints, which use `agent-memory-2026-07-22` instead. The SDK sets the correct beta header automatically. See [Beta headers](https://platform.claude.com/docs/en/api/beta-headers#endpoint-specific-headers).
11</Note>
11[Console](https://platform.claude.com/workspaces/default/agent-quickstart/) provides a visual interface for creating and configuring agents. It lets you iterate on configuration interactively before writing code.
1212
1313## How to build an agent
1414
managed-agents/overview Changed · +4 / -0 lines
## Compatibility
from line 4
44description: Pre-built, configurable agent harness that runs in managed infrastructure. Best for long-running tasks and asynchronous work.
55---
66
7## Compatibility
8- Status: Beta
9- [Beta header](https://platform.claude.com/docs/en/api/beta-headers): `managed-agents-2026-04-01`
10
711Anthropic offers two ways to build with Claude, each suited to different use cases:
812
913| | Messages API | Claude Managed Agents |