Skip to content

Commit ed9b545

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

1 file changed

Lines changed: 127 additions & 0 deletions

File tree

‎.speakeasy/in.openapi.yaml‎

Lines changed: 127 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13110,6 +13110,22 @@ components:
1311013110
- 'content'
1311113111
- 'role'
1311213112
type: 'object'
13113+
InternDaemonAccess:
13114+
description: 'The intern daemon''s origin and the bearer `ori tui --host` sends to it as `ORI_DAEMON_TOKEN`.'
13115+
example:
13116+
origin: 'https://research-assistant-7c9e6679.or.bot'
13117+
token: 'daemon_token'
13118+
properties:
13119+
origin:
13120+
pattern: '^https?:\/\/([a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)*)(?::(\d{1,5}))?$/iu'
13121+
type: 'string'
13122+
token:
13123+
pattern: '^[\w-]+$/u'
13124+
type: 'string'
13125+
required:
13126+
- 'origin'
13127+
- 'token'
13128+
type: 'object'
1311313129
InternInvokeAcceptedResponse:
1311413130
description: 'The intern admitted the prompt. The run continues on the intern.'
1311513131
example:
@@ -37354,6 +37370,117 @@ paths:
3735437370
- 'Interns'
3735537371
x-speakeasy-group: 'interns'
3735637372
x-speakeasy-name-override: 'chat'
37373+
/interns/{internId}/daemon-access:
37374+
get:
37375+
description: 'Returns the origin and daemon token that attach `ori tui --host` to one visible, running intern. The token is a credential: the response is sent with `Cache-Control: no-store`, each reveal is logged by caller and intern, and a caller may make 10 reveals per minute. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.'
37376+
operationId: 'getInternDaemonAccess'
37377+
parameters:
37378+
- description: 'ID of an intern visible to the authenticated API key.'
37379+
in: 'path'
37380+
name: 'internId'
37381+
required: true
37382+
schema:
37383+
description: 'ID of an intern visible to the authenticated API key.'
37384+
example: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
37385+
minLength: 1
37386+
type: 'string'
37387+
responses:
37388+
'200':
37389+
content:
37390+
application/json:
37391+
schema:
37392+
$ref: '#/components/schemas/InternDaemonAccess'
37393+
description: 'Daemon origin and token.'
37394+
'401':
37395+
content:
37396+
application/json:
37397+
example:
37398+
error:
37399+
code: 401
37400+
message: 'Invalid or missing API key'
37401+
schema:
37402+
$ref: '#/components/schemas/InternLifecycleError'
37403+
description: 'Missing, unknown or provisioning API key.'
37404+
'403':
37405+
content:
37406+
application/json:
37407+
example:
37408+
error:
37409+
code: 403
37410+
message: 'Forbidden'
37411+
schema:
37412+
$ref: '#/components/schemas/InternLifecycleError'
37413+
description: 'The key owner no longer has access, or the request used a regional hostname.'
37414+
'404':
37415+
content:
37416+
application/json:
37417+
example:
37418+
error:
37419+
code: 404
37420+
message: 'Intern not found'
37421+
metadata:
37422+
reason: 'not_found'
37423+
retryable: false
37424+
schema:
37425+
$ref: '#/components/schemas/InternLifecycleError'
37426+
description: 'The caller is outside the Intern API programme, the intern is hidden, or lifecycle writes are disabled.'
37427+
'408':
37428+
content:
37429+
application/json:
37430+
example:
37431+
error:
37432+
code: 408
37433+
message: 'Operation timed out after 10s. Please try again later.'
37434+
metadata:
37435+
reason: 'timeout'
37436+
retryable: true
37437+
schema:
37438+
$ref: '#/components/schemas/InternLifecycleError'
37439+
description: 'The request exceeded its route deadline. The deadline quoted in the message is the route''s own, so it differs between operations.'
37440+
'409':
37441+
content:
37442+
application/json:
37443+
example:
37444+
error:
37445+
code: 409
37446+
message: 'This intern is not running.'
37447+
metadata:
37448+
reason: 'intern_not_running'
37449+
retryable: false
37450+
schema:
37451+
$ref: '#/components/schemas/InternLifecycleError'
37452+
description: 'The intern cannot be attached to. `metadata.reason` is `intern_not_running`, `intern_unreachable` when it has no usable address yet, or `intern_needs_restart` when it was provisioned before daemon access was available.'
37453+
'429':
37454+
content:
37455+
application/json:
37456+
example:
37457+
error:
37458+
code: 429
37459+
message: 'Too many token reveals. Please wait a moment.'
37460+
metadata:
37461+
reason: 'rate_limited'
37462+
retryable: true
37463+
schema:
37464+
$ref: '#/components/schemas/InternLifecycleError'
37465+
description: 'The caller made more than 10 reveals in the last minute. Wait for `Retry-After` seconds.'
37466+
'500':
37467+
content:
37468+
application/json:
37469+
example:
37470+
error:
37471+
code: 500
37472+
message: 'The request could not be completed'
37473+
metadata:
37474+
reason: 'internal_error'
37475+
retryable: true
37476+
schema:
37477+
$ref: '#/components/schemas/InternLifecycleError'
37478+
description: 'The request could not be completed. `metadata.reason` says whether to try again: `internal_error` is a transient failure and carries `metadata.retryable: true`, so the same request may be sent again, while `configuration_error` carries `retryable: false` because the next attempt reads the same missing binding or unusable stored credential.'
37479+
security:
37480+
- apiKey: []
37481+
summary: 'Get an intern''s daemon access'
37482+
tags:
37483+
- 'Interns'
3735737484
/interns/{internId}/invoke:
3735837485
post:
3735937486
description: "Starts a run on one of your interns and answers `202` with the `session_id` as soon as the intern accepts it. The run keeps going on the intern after the response. Nothing about its progress comes back on this request; the intern reports through its own tools, such as Slack.\n\nSend the same `session_id` later to continue the conversation, for example to hand the intern a decision on work it started. If that session already has a run going, the prompt is delivered into it and the status is `steered`. A `session_id` is accepted only from the caller it was issued to, on the same intern; any other, including sessions started from Slack or the chat endpoint, is refused with `404`.\n\nRuns started here self-drive: the intern consents to its own tool approvals, and a question it asks is answered by its own fallback. A run ends when the intern finishes it or after its execution deadline (1 hour by default).\n\nAvailable to interns programme members. Callers outside the programme receive `404` for every path under `/api/v1/interns`."

0 commit comments

Comments
 (0)