Skip to content

Commit 0373c01

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

1 file changed

Lines changed: 119 additions & 0 deletions

File tree

‎.speakeasy/in.openapi.yaml‎

Lines changed: 119 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15039,8 +15039,10 @@ components:
1503915039
example:
1504015040
attached_vault_id: null
1504115041
created_at: '2026-09-16T08:30:00.000Z'
15042+
created_by_you: true
1504215043
description: 'Researches customer questions'
1504315044
hostname: 'research-assistant.openrouter.ai'
15045+
icon_sha256: null
1504415046
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
1504515047
instructions: null
1504615048
last_failure_message: null
@@ -15060,6 +15062,9 @@ components:
1506015062
created_at:
1506115063
description: 'ISO 8601 creation time.'
1506215064
type: 'string'
15065+
created_by_you:
15066+
description: 'Whether the user behind the key created the intern. Present on list and retrieve; absent for organization keys, which act for no user.'
15067+
type: 'boolean'
1506315068
description:
1506415069
description: 'Free-form description.'
1506515070
type:
@@ -15070,6 +15075,11 @@ components:
1507015075
type:
1507115076
- 'string'
1507215077
- 'null'
15078+
icon_sha256:
15079+
description: 'SHA-256 of the intern icon, or null when it has none. Present on list and retrieve; fetch the bytes from `GET /api/v1/interns/{intern_id}/icon`.'
15080+
type:
15081+
- 'string'
15082+
- 'null'
1507315083
id:
1507415084
description: 'Intern id.'
1507515085
type: 'string'
@@ -15814,8 +15824,10 @@ components:
1581415824
data:
1581515825
- attached_vault_id: null
1581615826
created_at: '2026-09-16T08:30:00.000Z'
15827+
created_by_you: true
1581715828
description: 'Researches customer questions'
1581815829
hostname: 'research-assistant.openrouter.ai'
15830+
icon_sha256: null
1581915831
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
1582015832
instructions: null
1582115833
last_failure_message: null
@@ -41956,8 +41968,10 @@ paths:
4195641968
data:
4195741969
- attached_vault_id: null
4195841970
created_at: '2026-09-16T08:30:00.000Z'
41971+
created_by_you: true
4195941972
description: 'Researches customer questions'
4196041973
hostname: 'research-assistant.openrouter.ai'
41974+
icon_sha256: null
4196141975
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
4196241976
instructions: null
4196341977
last_failure_message: null
@@ -42080,8 +42094,10 @@ paths:
4208042094
example:
4208142095
attached_vault_id: null
4208242096
created_at: '2026-09-16T08:30:00.000Z'
42097+
created_by_you: true
4208342098
description: 'Researches customer questions'
4208442099
hostname: 'research-assistant.openrouter.ai'
42100+
icon_sha256: null
4208542101
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
4208642102
instructions: null
4208742103
last_failure_message: null
@@ -42101,8 +42117,10 @@ paths:
4210142117
example:
4210242118
attached_vault_id: null
4210342119
created_at: '2026-09-16T08:30:00.000Z'
42120+
created_by_you: true
4210442121
description: 'Researches customer questions'
4210542122
hostname: 'research-assistant.openrouter.ai'
42123+
icon_sha256: null
4210642124
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
4210742125
instructions: null
4210842126
last_failure_message: null
@@ -42448,8 +42466,10 @@ paths:
4244842466
example:
4244942467
attached_vault_id: null
4245042468
created_at: '2026-09-16T08:30:00.000Z'
42469+
created_by_you: true
4245142470
description: 'Researches customer questions'
4245242471
hostname: 'research-assistant.openrouter.ai'
42472+
icon_sha256: null
4245342473
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
4245442474
instructions: null
4245542475
last_failure_message: null
@@ -42556,8 +42576,10 @@ paths:
4255642576
example:
4255742577
attached_vault_id: null
4255842578
created_at: '2026-09-16T08:30:00.000Z'
42579+
created_by_you: true
4255942580
description: 'Researches customer questions'
4256042581
hostname: 'research-assistant.openrouter.ai'
42582+
icon_sha256: null
4256142583
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
4256242584
instructions: null
4256342585
last_failure_message: null
@@ -43430,6 +43452,103 @@ paths:
4343043452
summary: 'Sign a daemon request with the caller''s identity'
4343143453
tags:
4343243454
- 'Interns'
43455+
/interns/{internId}/icon:
43456+
get:
43457+
description: 'Returns the icon image of one visible intern. Pass the intern''s `icon_sha256` as `v` to receive a response that can be cached indefinitely. The API key selects the caller, workspace and visible interns. An intern''s own API key sees only that intern: the collection and every other intern answer 404 to it. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required.'
43458+
operationId: 'getInternIcon'
43459+
parameters:
43460+
- description: 'ID of an intern visible to the authenticated API key.'
43461+
in: 'path'
43462+
name: 'internId'
43463+
required: true
43464+
schema:
43465+
description: 'ID of an intern visible to the authenticated API key.'
43466+
example: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
43467+
minLength: 1
43468+
type: 'string'
43469+
- description: 'The `icon_sha256` the caller expects.'
43470+
in: 'query'
43471+
name: 'v'
43472+
required: false
43473+
schema:
43474+
description: 'The `icon_sha256` the caller expects.'
43475+
type: 'string'
43476+
responses:
43477+
'200':
43478+
content:
43479+
image/jpeg:
43480+
schema:
43481+
format: 'binary'
43482+
type: 'string'
43483+
image/png:
43484+
schema:
43485+
format: 'binary'
43486+
type: 'string'
43487+
description: 'Icon image bytes.'
43488+
'401':
43489+
content:
43490+
application/json:
43491+
example:
43492+
error:
43493+
code: 401
43494+
message: 'Invalid or missing API key'
43495+
schema:
43496+
$ref: '#/components/schemas/InternLifecycleError'
43497+
description: 'Missing, unknown or provisioning API key.'
43498+
'403':
43499+
content:
43500+
application/json:
43501+
example:
43502+
error:
43503+
code: 403
43504+
message: 'Forbidden'
43505+
schema:
43506+
$ref: '#/components/schemas/InternLifecycleError'
43507+
description: 'The key owner no longer has access, or the request used a regional hostname.'
43508+
'404':
43509+
content:
43510+
application/json:
43511+
example:
43512+
error:
43513+
code: 404
43514+
message: 'Intern not found'
43515+
metadata:
43516+
reason: 'not_found'
43517+
retryable: false
43518+
schema:
43519+
$ref: '#/components/schemas/InternLifecycleError'
43520+
description: 'The caller is outside the Intern API programme, the intern is hidden, or lifecycle writes are disabled.'
43521+
'408':
43522+
content:
43523+
application/json:
43524+
example:
43525+
error:
43526+
code: 408
43527+
message: 'Operation timed out after 10s. Please try again later.'
43528+
metadata:
43529+
reason: 'timeout'
43530+
retryable: true
43531+
schema:
43532+
$ref: '#/components/schemas/InternLifecycleError'
43533+
description: 'The request exceeded its route deadline. The deadline quoted in the message is the route''s own, so it differs between operations.'
43534+
'500':
43535+
content:
43536+
application/json:
43537+
example:
43538+
error:
43539+
code: 500
43540+
message: 'The request could not be completed'
43541+
metadata:
43542+
reason: 'internal_error'
43543+
retryable: true
43544+
schema:
43545+
$ref: '#/components/schemas/InternLifecycleError'
43546+
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.'
43547+
security:
43548+
- apiKey: []
43549+
summary: 'Get an intern''s icon'
43550+
tags:
43551+
- 'Interns'
4343343552
/interns/{internId}/invoke:
4343443553
post:
4343543554
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)