Skip to content

Commit 54c8637

Browse files
openrouter-docs-sync[bot]OpenRouter SDK Bot
andauthored
chore: update OpenAPI spec from monorepo (#1231)
Co-authored-by: OpenRouter SDK Bot <sdk-bot@openrouter.ai>
1 parent ed708f5 commit 54c8637

1 file changed

Lines changed: 88 additions & 2 deletions

File tree

‎.speakeasy/in.openapi.yaml‎

Lines changed: 88 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8661,6 +8661,8 @@ components:
86618661
- 'null'
86628662
cost_details:
86638663
$ref: '#/components/schemas/CostDetails'
8664+
deferred_tools_details:
8665+
$ref: '#/components/schemas/DeferredToolsDetails'
86648666
is_byok:
86658667
description: 'Whether a request was made using a Bring Your Own Key configuration'
86668668
type: 'boolean'
@@ -11430,9 +11432,10 @@ components:
1143011432
validation: 'runtime'
1143111433
properties:
1143211434
profile:
11433-
description: 'Loading profile. Only `portable` is available in this release: OpenRouter serves deferral with router-built search and call wrappers on any model.'
11435+
description: 'Loading profile. `portable` serves the `defer_loading` tools with router-built search and call wrappers on any model and keeps the catalog fixed. `universal` defers every wrappable tool behind the same wrappers so the provider-facing tool list never changes, and rebuilds the catalog from each request so tools can be added or removed mid-conversation.'
1143411436
enum:
1143511437
- 'portable'
11438+
- 'universal'
1143611439
type: 'string'
1143711440
protocol:
1143811441
enum:
@@ -11451,6 +11454,34 @@ components:
1145111454
- 'validation'
1145211455
- 'search'
1145311456
type: 'object'
11457+
DeferredToolsDetails:
11458+
description: 'Totals across every upstream model call of a deferred-tools run. The native usage fields report only the final call; cost covers every call.'
11459+
example:
11460+
completion_tokens: 180
11461+
prompt_tokens: 2400
11462+
total_tokens: 2580
11463+
turns: 2
11464+
properties:
11465+
completion_tokens:
11466+
description: 'Completion tokens summed over every upstream call'
11467+
type: 'integer'
11468+
prompt_tokens:
11469+
description: 'Prompt tokens summed over every upstream call'
11470+
type: 'integer'
11471+
total_tokens:
11472+
description: 'Sum of the above two fields'
11473+
type: 'integer'
11474+
turns:
11475+
description: 'Upstream model calls the run made'
11476+
exclusiveMinimum: true
11477+
minimum: 0
11478+
type: 'integer'
11479+
required:
11480+
- 'turns'
11481+
- 'prompt_tokens'
11482+
- 'completion_tokens'
11483+
- 'total_tokens'
11484+
type: 'object'
1145411485
DeferredToolsSearchStrategy:
1145511486
description: 'Router-local regex/BM25 or caller-owned custom search.'
1145611487
discriminator:
@@ -18835,6 +18866,28 @@ components:
1883518866
- 'null'
1883618867
cost_details:
1883718868
$ref: '#/components/schemas/CostDetails'
18869+
deferred_tools_details:
18870+
properties:
18871+
completion_tokens:
18872+
description: 'Completion tokens summed over every upstream call'
18873+
type: 'integer'
18874+
prompt_tokens:
18875+
description: 'Prompt tokens summed over every upstream call'
18876+
type: 'integer'
18877+
total_tokens:
18878+
description: 'Sum of the above two fields'
18879+
type: 'integer'
18880+
turns:
18881+
description: 'Upstream model calls the run made'
18882+
exclusiveMinimum: true
18883+
minimum: 0
18884+
type: 'integer'
18885+
required:
18886+
- 'turns'
18887+
- 'prompt_tokens'
18888+
- 'completion_tokens'
18889+
- 'total_tokens'
18890+
type: 'object'
1883818891
is_byok:
1883918892
type: 'boolean'
1884018893
iterations:
@@ -25989,10 +26042,32 @@ components:
2598926042
status: 'completed'
2599026043
type: 'openrouter:tool_search'
2599126044
properties:
26045+
arguments:
26046+
description: 'The JSON arguments of the model call, verbatim. Replaying the item reuses them.'
26047+
example: '{"query":"weather tools"}'
26048+
type: 'string'
26049+
call_id:
26050+
description: 'The ID of the model call that ran the search. Replaying the item reuses it.'
26051+
example: 'call_search_1'
26052+
type: 'string'
26053+
catalog_index:
26054+
description: 'The deferred-tool index the router showed the model with a pre-search, listing tool sources and names. Replaying the item shows the same index.'
26055+
example: "Deferred tools, found with tool_search and called with tool_exec:\nSources: mcp__sentry (12)."
26056+
type: 'string'
2599226057
error:
2599326058
description: 'The error message when the tool call failed before producing a result. Set together with `status: ''failed''`; absent on a successful call.'
2599426059
example: 'Tool execution failed'
2599526060
type: 'string'
26061+
format:
26062+
description: 'How the model saw the matches. `compact` means each tool by name, description, and input shape, plus a call example. Replaying the item renders the same result.'
26063+
enum:
26064+
- 'compact'
26065+
example: 'compact'
26066+
type: 'string'
26067+
hint:
26068+
description: 'The guidance the model got when the search matched no tools.'
26069+
example: 'No tools matched. Search again with other keywords, or load tools by exact name with "select:Name1,Name2".'
26070+
type: 'string'
2599626071
id:
2599726072
type: 'string'
2599826073
matches:
@@ -26015,6 +26090,14 @@ components:
2601526090
type: 'string'
2601626091
status:
2601726092
$ref: '#/components/schemas/FailableToolCallStatus'
26093+
turn_call_ids:
26094+
description: 'The IDs of every tool call in the model response that ran the search, in order. Replaying the item keeps those calls in one turn.'
26095+
example:
26096+
- 'call_search_1'
26097+
- 'call_exec_1'
26098+
items:
26099+
type: 'string'
26100+
type: 'array'
2601826101
type:
2601926102
enum:
2602026103
- 'openrouter:tool_search'
@@ -34332,6 +34415,8 @@ components:
3433234415
- 'upstream_inference_input_cost'
3433334416
- 'upstream_inference_output_cost'
3433434417
type: 'object'
34418+
deferred_tools_details:
34419+
$ref: '#/components/schemas/DeferredToolsDetails'
3433534420
is_byok:
3433634421
description: 'Whether a request was made using a Bring Your Own Key configuration'
3433734422
type: 'boolean'
@@ -47784,10 +47869,11 @@ paths:
4778447869
- 'string'
4778547870
- 'null'
4778647871
role:
47787-
description: 'Role of the member in the organization'
47872+
description: 'Role of the member in the organization. `org:viewer` is coming soon and not yet available. Once launched, it has read-only organization access: it can view organization settings, billing and workspaces but not change them. Workspace roles can still grant write access in specific workspaces.'
4778847873
enum:
4778947874
- 'org:admin'
4779047875
- 'org:member'
47876+
- 'org:viewer'
4779147877
example: 'org:member'
4779247878
type: 'string'
4779347879
required:

0 commit comments

Comments
 (0)