@@ -3593,6 +3593,7 @@ components:
35933593 - $ref: '#/components/schemas/DatetimeServerTool'
35943594 - $ref: '#/components/schemas/ImageGenerationServerTool_OpenRouter'
35953595 - $ref: '#/components/schemas/ChatSearchModelsServerTool'
3596+ - $ref: '#/components/schemas/WebFetchServerTool'
35963597 - $ref: '#/components/schemas/OpenRouterWebSearchServerTool'
35973598 - $ref: '#/components/schemas/ChatWebSearchShorthand'
35983599 description: Tool definition for function calling (regular function or OpenRouter built-in server tool)
@@ -5998,6 +5999,11 @@ components:
59985999 example: 5
59996000 nullable: true
60006001 type: integer
6002+ num_fetches:
6003+ description: Number of web fetches performed
6004+ example: 0
6005+ nullable: true
6006+ type: integer
60016007 num_input_audio_prompt:
60026008 description: Number of audio inputs in the prompt
60036009 example: 0
@@ -6119,6 +6125,7 @@ components:
61196125 - num_input_audio_prompt
61206126 - num_media_completion
61216127 - num_search_results
6128+ - num_fetches
61226129 - web_search_engine
61236130 - origin
61246131 - usage
@@ -8264,6 +8271,7 @@ components:
82648271 - $ref: '#/components/schemas/DatetimeServerTool'
82658272 - $ref: '#/components/schemas/ImageGenerationServerTool_OpenRouter'
82668273 - $ref: '#/components/schemas/ChatSearchModelsServerTool'
8274+ - $ref: '#/components/schemas/WebFetchServerTool'
82678275 - $ref: '#/components/schemas/OpenRouterWebSearchServerTool'
82688276 type: array
82698277 top_k:
@@ -12230,6 +12238,7 @@ components:
1223012238 - $ref: '#/components/schemas/DatetimeServerTool'
1223112239 - $ref: '#/components/schemas/ImageGenerationServerTool_OpenRouter'
1223212240 - $ref: '#/components/schemas/ChatSearchModelsServerTool'
12241+ - $ref: '#/components/schemas/WebFetchServerTool'
1223312242 - $ref: '#/components/schemas/WebSearchServerTool_OpenRouter'
1223412243 type: array
1223512244 top_k:
@@ -12273,8 +12282,8 @@ components:
1227312282 type: object
1227412283 SearchQualityLevel:
1227512284 description: >-
12276- How much context to retrieve per result. Defaults to medium (15000 chars). Only applies when using the Exa
12277- engine; ignored with native provider search.
12285+ How much context to retrieve per result. Defaults to medium (15000 chars). Applies to Exa and Parallel engines;
12286+ ignored with native provider search and Firecrawl .
1227812287 enum:
1227912288 - low
1228012289 - medium
@@ -14350,6 +14359,62 @@ components:
1435014359 required:
1435114360 - data
1435214361 type: object
14362+ WebFetchEngineEnum:
14363+ description: >-
14364+ Which fetch engine to use. "auto" (default) uses native if the provider supports it, otherwise Exa. "native"
14365+ forces the provider's built-in fetch. "exa" uses Exa Contents API (supports BYOK). "openrouter" uses direct HTTP
14366+ fetch. "firecrawl" uses Firecrawl scrape (requires BYOK).
14367+ enum:
14368+ - auto
14369+ - native
14370+ - openrouter
14371+ - firecrawl
14372+ - exa
14373+ example: auto
14374+ type: string
14375+ WebFetchServerTool:
14376+ description: 'OpenRouter built-in server tool: fetches full content from a URL (web page or PDF)'
14377+ example:
14378+ parameters:
14379+ max_uses: 10
14380+ type: openrouter:web_fetch
14381+ properties:
14382+ parameters:
14383+ $ref: '#/components/schemas/WebFetchServerToolConfig'
14384+ type:
14385+ enum:
14386+ - openrouter:web_fetch
14387+ type: string
14388+ required:
14389+ - type
14390+ type: object
14391+ WebFetchServerToolConfig:
14392+ description: Configuration for the openrouter:web_fetch server tool
14393+ example:
14394+ max_content_tokens: 100000
14395+ max_uses: 10
14396+ properties:
14397+ allowed_domains:
14398+ description: Only fetch from these domains.
14399+ items:
14400+ type: string
14401+ type: array
14402+ blocked_domains:
14403+ description: Never fetch from these domains.
14404+ items:
14405+ type: string
14406+ type: array
14407+ engine:
14408+ $ref: '#/components/schemas/WebFetchEngineEnum'
14409+ max_content_tokens:
14410+ description: Maximum content length in approximate tokens. Content exceeding this limit is truncated.
14411+ example: 100000
14412+ type: integer
14413+ max_uses:
14414+ description: Maximum number of web fetches per request. Once exceeded, the tool returns an error.
14415+ example: 10
14416+ type: integer
14417+ type: object
1435314418 WebSearchCallCompletedEvent:
1435414419 allOf:
1435514420 - $ref: '#/components/schemas/OpenAIResponsesSearchCompleted'
0 commit comments