From 7b10fd47d86a66281782beb63d83e6365925745a Mon Sep 17 00:00:00 2001 From: robert-j-y <212159665+robert-j-y@users.noreply.github.com> Date: Fri, 12 Jun 2026 07:28:06 -0700 Subject: [PATCH] chore: update OpenAPI spec from monorepo (#310) Co-authored-by: OpenRouter SDK Bot --- .speakeasy/in.openapi.yaml | 104 ++++++++++++++++++++----------------- 1 file changed, 57 insertions(+), 47 deletions(-) diff --git a/.speakeasy/in.openapi.yaml b/.speakeasy/in.openapi.yaml index 72dc7d2..b523858 100644 --- a/.speakeasy/in.openapi.yaml +++ b/.speakeasy/in.openapi.yaml @@ -5827,8 +5827,8 @@ components: properties: allowed_domains: description: >- - Limit search results to these domains. Supported by Exa, Firecrawl, Parallel, and most native providers - (Anthropic, OpenAI, xAI). Not supported with Perplexity. Cannot be used with excluded_domains. + Limit search results to these domains. Supported by Exa, Firecrawl, Parallel, Perplexity, and most native + providers (Anthropic, OpenAI, xAI). Cannot be used with excluded_domains. items: type: string type: array @@ -5836,24 +5836,26 @@ components: $ref: '#/components/schemas/WebSearchEngineEnum' excluded_domains: description: >- - Exclude search results from these domains. Supported by Exa, Firecrawl, Parallel, Anthropic, and xAI. Not - supported with OpenAI (silently ignored) or Perplexity. Cannot be used with allowed_domains. + Exclude search results from these domains. Supported by Exa, Firecrawl, Parallel, Perplexity, Anthropic, and + xAI. Not supported with OpenAI (silently ignored). Cannot be used with allowed_domains. items: type: string type: array max_characters: description: >- - Exact maximum number of characters of content per search result. Applies to the Exa and Parallel engines; - ignored with native provider search and Firecrawl. For Exa, caps highlight content per result. For Parallel, - caps excerpt content per result (default 1,500 when omitted). When both `max_characters` and - `search_context_size` are set, `max_characters` takes precedence for both engines. When omitted, falls back - to `search_context_size` mapping (Exa) or engine defaults (Parallel). + Exact maximum number of characters of content per search result. Applies to the Exa, Parallel, and + Perplexity engines; ignored with native provider search and Firecrawl. For Exa, caps highlight content per + result. For Parallel, caps excerpt content per result (default 1,500 when omitted). For Perplexity, maps to + the native `max_tokens_per_page` parameter (converted from characters to tokens) and trims the response to + the exact character cap. When both `max_characters` and `search_context_size` are set, `max_characters` + takes precedence. When omitted, falls back to `search_context_size` mapping (Exa) or engine defaults + (Parallel, Perplexity). example: 2000 type: integer max_results: description: >- - Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, and - Parallel engines; ignored with native provider search. + Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, + Parallel, and Perplexity engines; ignored with native provider search. example: 5 type: integer max_total_results: @@ -9912,8 +9914,8 @@ components: $ref: '#/components/schemas/WebSearchDomainFilter' max_results: description: >- - Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, and - Parallel engines; ignored with native provider search. + Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, + Parallel, and Perplexity engines; ignored with native provider search. example: 5 type: integer search_context_size: @@ -17046,8 +17048,8 @@ components: $ref: '#/components/schemas/WebSearchDomainFilter' max_results: description: >- - Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, and - Parallel engines; ignored with native provider search. + Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, + Parallel, and Perplexity engines; ignored with native provider search. example: 5 type: integer search_context_size: @@ -17072,8 +17074,8 @@ components: $ref: '#/components/schemas/WebSearchDomainFilter' max_results: description: >- - Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, and - Parallel engines; ignored with native provider search. + Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, + Parallel, and Perplexity engines; ignored with native provider search. example: 5 type: integer search_context_size: @@ -19174,11 +19176,12 @@ components: type: object SearchQualityLevel: description: >- - How much context to retrieve per result. Applies to Exa and Parallel engines; ignored with native provider - search and Firecrawl. For Exa, pins a fixed per-result character cap (low=5,000, medium=15,000, high=30,000); - when omitted, Exa picks an adaptive size per query and document (typically ~2,000–4,000 characters per result). - For Parallel, controls the total characters across all results; when omitted, Parallel uses its own default - size. Overridden by `max_characters` when both are set. + How much context to retrieve per result. Applies to Exa, Parallel, and Perplexity engines; ignored with native + provider search and Firecrawl. For Exa, pins a fixed per-result character cap (low=5,000, medium=15,000, + high=30,000); when omitted, Exa picks an adaptive size per query and document (typically ~2,000–4,000 characters + per result). For Parallel, controls the total characters across all results; when omitted, Parallel uses its own + default size. For Perplexity, maps directly to the Search API's native search_context_size parameter. Overridden + by `max_characters` when both are set. enum: - low - medium @@ -21177,8 +21180,8 @@ components: properties: allowed_domains: description: >- - Limit search results to these domains. Supported by Exa, Firecrawl, Parallel, and most native providers - (Anthropic, OpenAI, xAI). Not supported with Perplexity. Cannot be used with excluded_domains. + Limit search results to these domains. Supported by Exa, Firecrawl, Parallel, Perplexity, and most native + providers (Anthropic, OpenAI, xAI). Cannot be used with excluded_domains. items: type: string type: array @@ -21186,24 +21189,26 @@ components: $ref: '#/components/schemas/WebSearchEngineEnum' excluded_domains: description: >- - Exclude search results from these domains. Supported by Exa, Firecrawl, Parallel, Anthropic, and xAI. Not - supported with OpenAI (silently ignored) or Perplexity. Cannot be used with allowed_domains. + Exclude search results from these domains. Supported by Exa, Firecrawl, Parallel, Perplexity, Anthropic, and + xAI. Not supported with OpenAI (silently ignored). Cannot be used with allowed_domains. items: type: string type: array max_characters: description: >- - Exact maximum number of characters of content per search result. Applies to the Exa and Parallel engines; - ignored with native provider search and Firecrawl. For Exa, caps highlight content per result. For Parallel, - caps excerpt content per result (default 1,500 when omitted). When both `max_characters` and - `search_context_size` are set, `max_characters` takes precedence for both engines. When omitted, falls back - to `search_context_size` mapping (Exa) or engine defaults (Parallel). + Exact maximum number of characters of content per search result. Applies to the Exa, Parallel, and + Perplexity engines; ignored with native provider search and Firecrawl. For Exa, caps highlight content per + result. For Parallel, caps excerpt content per result (default 1,500 when omitted). For Perplexity, maps to + the native `max_tokens_per_page` parameter (converted from characters to tokens) and trims the response to + the exact character cap. When both `max_characters` and `search_context_size` are set, `max_characters` + takes precedence. When omitted, falls back to `search_context_size` mapping (Exa) or engine defaults + (Parallel, Perplexity). example: 2000 type: integer max_results: description: >- - Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, and - Parallel engines; ignored with native provider search. + Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, + Parallel, and Perplexity engines; ignored with native provider search. example: 5 type: integer max_total_results: @@ -21244,19 +21249,22 @@ components: - exa - firecrawl - parallel + - perplexity example: exa type: string WebSearchEngineEnum: description: >- Which search engine to use. "auto" (default) uses native if the provider supports it, otherwise Exa. "native" forces the provider's built-in search. "exa" forces the Exa search API. "firecrawl" uses Firecrawl (requires - BYOK). "parallel" uses the Parallel search API. + BYOK). "parallel" uses the Parallel search API. "perplexity" uses the Perplexity Search API (raw ranked + results). enum: - auto - native - exa - parallel - firecrawl + - perplexity example: auto type: string WebSearchPlugin: @@ -21337,8 +21345,8 @@ components: $ref: '#/components/schemas/WebSearchDomainFilter' max_results: description: >- - Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, and - Parallel engines; ignored with native provider search. + Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, + Parallel, and Perplexity engines; ignored with native provider search. example: 5 type: integer search_context_size: @@ -21376,8 +21384,8 @@ components: properties: allowed_domains: description: >- - Limit search results to these domains. Supported by Exa, Firecrawl, Parallel, and most native providers - (Anthropic, OpenAI, xAI). Not supported with Perplexity. Cannot be used with excluded_domains. + Limit search results to these domains. Supported by Exa, Firecrawl, Parallel, Perplexity, and most native + providers (Anthropic, OpenAI, xAI). Cannot be used with excluded_domains. items: type: string type: array @@ -21385,24 +21393,26 @@ components: $ref: '#/components/schemas/WebSearchEngineEnum' excluded_domains: description: >- - Exclude search results from these domains. Supported by Exa, Firecrawl, Parallel, Anthropic, and xAI. Not - supported with OpenAI (silently ignored) or Perplexity. Cannot be used with allowed_domains. + Exclude search results from these domains. Supported by Exa, Firecrawl, Parallel, Perplexity, Anthropic, and + xAI. Not supported with OpenAI (silently ignored). Cannot be used with allowed_domains. items: type: string type: array max_characters: description: >- - Exact maximum number of characters of content per search result. Applies to the Exa and Parallel engines; - ignored with native provider search and Firecrawl. For Exa, caps highlight content per result. For Parallel, - caps excerpt content per result (default 1,500 when omitted). When both `max_characters` and - `search_context_size` are set, `max_characters` takes precedence for both engines. When omitted, falls back - to `search_context_size` mapping (Exa) or engine defaults (Parallel). + Exact maximum number of characters of content per search result. Applies to the Exa, Parallel, and + Perplexity engines; ignored with native provider search and Firecrawl. For Exa, caps highlight content per + result. For Parallel, caps excerpt content per result (default 1,500 when omitted). For Perplexity, maps to + the native `max_tokens_per_page` parameter (converted from characters to tokens) and trims the response to + the exact character cap. When both `max_characters` and `search_context_size` are set, `max_characters` + takes precedence. When omitted, falls back to `search_context_size` mapping (Exa) or engine defaults + (Parallel, Perplexity). example: 2000 type: integer max_results: description: >- - Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, and - Parallel engines; ignored with native provider search. + Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, + Parallel, and Perplexity engines; ignored with native provider search. example: 5 type: integer max_total_results: