Skip to content

Commit 35e77e7

Browse files
openrouter-docs-sync[bot]OpenRouter SDK Bot
andauthored
chore: update OpenAPI spec from monorepo (#1099)
Co-authored-by: OpenRouter SDK Bot <sdk-bot@openrouter.ai>
1 parent 4b689be commit 35e77e7

1 file changed

Lines changed: 196 additions & 0 deletions

File tree

‎.speakeasy/in.openapi.yaml‎

Lines changed: 196 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51506,6 +51506,202 @@ paths:
5150651506
summary: 'Get a server tool'
5150751507
tags:
5150851508
- 'Tools'
51509+
/vault/interns/{internId}/connections:
51510+
get:
51511+
description: 'Lists the connections in scope for the intern, by the key of their card on the dashboard''s Connections tab: `github`, `slack`, `google`, a catalog MCP server such as `linear` or `notion`, or `mcp:<host>` for a custom MCP server. A connection is listed when it is stored, enabled, and not turned off or hidden for this intern, as the Connections tab lists it; whether its last test passed is not part of the rule. `ori features add` checks a feature''s `ori.requires.connections` against this list. Keys only, never credentials. Returns 404 for an intern the key cannot see. The scope is selected by the API key: workspace routes act on the key''s active workspace and intern routes act on one intern inside that workspace. There is no default workspace and no fallback to another scope. Every vault route, including reads, requires access to the Intern API programme and returns 404 outside it. An intern''s own API key is confined to that intern: it can always read the intern''s secrets and effective secrets, writes to them follow the rules above, and every other intern and every workspace route answers 404. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.'
51512+
operationId: 'listInternConnections'
51513+
parameters:
51514+
- description: 'UUID of an intern in the workspace selected by the API key.'
51515+
in: 'path'
51516+
name: 'internId'
51517+
required: true
51518+
schema:
51519+
description: 'UUID of an intern in the workspace selected by the API key.'
51520+
example: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
51521+
format: 'uuid'
51522+
type: 'string'
51523+
responses:
51524+
'200':
51525+
content:
51526+
application/json:
51527+
example:
51528+
data:
51529+
- key: 'github'
51530+
- key: 'linear'
51531+
schema:
51532+
properties:
51533+
data:
51534+
items:
51535+
properties:
51536+
key:
51537+
type: 'string'
51538+
required:
51539+
- 'key'
51540+
type: 'object'
51541+
type: 'array'
51542+
required:
51543+
- 'data'
51544+
type: 'object'
51545+
description: 'The connections the intern can use.'
51546+
'400':
51547+
content:
51548+
application/json:
51549+
examples:
51550+
invalid-vault-request:
51551+
summary: 'Invalid vault request'
51552+
value:
51553+
error:
51554+
code: 400
51555+
message: 'Invalid vault request'
51556+
schema:
51557+
$ref: '#/components/schemas/BadRequestResponse'
51558+
description: 'Bad Request - The secret name, path, query or JSON body failed validation. The vault returns 400 for a malformed request as well.'
51559+
'401':
51560+
content:
51561+
application/json:
51562+
examples:
51563+
invalid-or-missing-api-key:
51564+
summary: 'Invalid or missing API key'
51565+
value:
51566+
error:
51567+
code: 401
51568+
message: 'Invalid or missing API key'
51569+
schema:
51570+
$ref: '#/components/schemas/UnauthorizedResponse'
51571+
description: 'Unauthorized - Missing or unknown API key. Provisioning keys cannot call vault routes.'
51572+
'403':
51573+
content:
51574+
application/json:
51575+
examples:
51576+
regional-hostname:
51577+
summary: 'Regional hostname'
51578+
value:
51579+
error:
51580+
code: 403
51581+
message: 'The Intern API does not support regional data residency yet. Please use the global endpoint at openrouter.ai.'
51582+
workspace-scope-unavailable:
51583+
summary: 'Workspace scope unavailable'
51584+
value:
51585+
error:
51586+
code: 403
51587+
message: 'Vault scope is unavailable'
51588+
schema:
51589+
$ref: '#/components/schemas/ForbiddenResponse'
51590+
description: 'Forbidden - The key has no usable workspace scope, or the request arrived on a regional hostname.'
51591+
'404':
51592+
content:
51593+
application/json:
51594+
examples:
51595+
not-found:
51596+
summary: 'Not found'
51597+
value:
51598+
error:
51599+
code: 404
51600+
message: 'Not found'
51601+
schema:
51602+
$ref: '#/components/schemas/NotFoundResponse'
51603+
description: 'Not Found - The intern is not in the selected workspace or is not visible to the key (a member key without an admin role sees only interns its member created or interns in workspaces they administer), the secret does not exist in the selected scope, or the caller is outside the intern programme.'
51604+
'408':
51605+
content:
51606+
application/json:
51607+
examples:
51608+
body-timed-out:
51609+
summary: 'Body timed out'
51610+
value:
51611+
error:
51612+
code: 408
51613+
message: 'Request body timed out'
51614+
route-deadline:
51615+
summary: 'Route deadline'
51616+
value:
51617+
error:
51618+
code: 408
51619+
message: 'Vault request timed out'
51620+
schema:
51621+
$ref: '#/components/schemas/RequestTimeoutResponse'
51622+
description: 'Request Timeout - The route deadline passed before the request completed, or the request body stopped arriving.'
51623+
'429':
51624+
content:
51625+
application/json:
51626+
examples:
51627+
rate-limited:
51628+
summary: 'Rate limited'
51629+
value:
51630+
error:
51631+
code: 429
51632+
message: 'Too many vault requests'
51633+
schema:
51634+
$ref: '#/components/schemas/TooManyRequestsResponse'
51635+
description: 'Too Many Requests - The vault rate limit was reached.'
51636+
'500':
51637+
content:
51638+
application/json:
51639+
examples:
51640+
internal-error:
51641+
summary: 'Internal error'
51642+
value:
51643+
error:
51644+
code: 500
51645+
message: 'Internal Server Error'
51646+
schema:
51647+
$ref: '#/components/schemas/InternalServerResponse'
51648+
description: 'Internal Server Error - Scope lookup failed.'
51649+
'502':
51650+
content:
51651+
application/json:
51652+
examples:
51653+
invalid-vault-response:
51654+
summary: 'Invalid vault response'
51655+
value:
51656+
error:
51657+
code: 502
51658+
message: 'Invalid vault response'
51659+
vault-request-failed:
51660+
summary: 'Vault request failed'
51661+
value:
51662+
error:
51663+
code: 502
51664+
message: 'Vault request failed'
51665+
schema:
51666+
$ref: '#/components/schemas/BadGatewayResponse'
51667+
description: 'Bad Gateway - The vault could not be reached or returned an unexpected response.'
51668+
'503':
51669+
content:
51670+
application/json:
51671+
examples:
51672+
vault-unavailable:
51673+
summary: 'Vault unavailable'
51674+
value:
51675+
error:
51676+
code: 503
51677+
message: 'Vault service is unavailable'
51678+
writes-disabled:
51679+
summary: 'Writes disabled'
51680+
value:
51681+
error:
51682+
code: 503
51683+
message: 'Vault writes are not enabled'
51684+
schema:
51685+
$ref: '#/components/schemas/ServiceUnavailableResponse'
51686+
description: 'Service Unavailable - Vault writes are disabled for the caller, or the vault is not configured.'
51687+
'504':
51688+
content:
51689+
application/json:
51690+
examples:
51691+
vault-timed-out:
51692+
summary: 'Vault timed out'
51693+
value:
51694+
error:
51695+
code: 504
51696+
message: 'Vault request timed out'
51697+
schema:
51698+
$ref: '#/components/schemas/GatewayTimeoutResponse'
51699+
description: 'Gateway Timeout - The vault did not answer in time.'
51700+
security:
51701+
- apiKey: []
51702+
summary: 'List the connections an intern can use'
51703+
tags:
51704+
- 'Vault'
5150951705
/vault/interns/{internId}/effective-secrets:
5151051706
get:
5151151707
description: 'Lists, one entry per name, the secret the intern''s outbound requests receive: its own secrets, secrets from an attached vault, and workspace secrets, including ones stored before workspace-scoped storage. Where several vaults hold a name, the entry is the one that wins, in the order intern, attached, workspace. The same resolution decides what outbound requests receive, so this list and the intern''s requests agree. `scope` says which vault the entry comes from. Responses carry metadata only, never values. Results are ordered by name and paginated with `limit` and `offset`. Returns 404 when the intern''s attached vault is no longer available, since the intern then receives no secrets. The scope is selected by the API key: workspace routes act on the key''s active workspace and intern routes act on one intern inside that workspace. There is no default workspace and no fallback to another scope. Every vault route, including reads, requires access to the Intern API programme and returns 404 outside it. An intern''s own API key is confined to that intern: it can always read the intern''s secrets and effective secrets, writes to them follow the rules above, and every other intern and every workspace route answers 404. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.'

0 commit comments

Comments
 (0)