You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit a6d9d5a
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: .speakeasy/out.openapi.yaml
+123Lines changed: 123 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -15173,8 +15173,10 @@ components:
15173
15173
example:
15174
15174
attached_vault_id: null
15175
15175
created_at: '2026-09-16T08:30:00.000Z'
15176
+
created_by_you: true
15176
15177
description: 'Researches customer questions'
15177
15178
hostname: 'research-assistant.openrouter.ai'
15179
+
icon_sha256: null
15178
15180
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
15179
15181
instructions: null
15180
15182
last_failure_message: null
@@ -15194,6 +15196,9 @@ components:
15194
15196
created_at:
15195
15197
description: 'ISO 8601 creation time.'
15196
15198
type: 'string'
15199
+
created_by_you:
15200
+
description: 'Whether the user behind the key created the intern. Present on list and retrieve; absent for organization keys, which act for no user.'
15201
+
type: 'boolean'
15197
15202
description:
15198
15203
description: 'Free-form description.'
15199
15204
type:
@@ -15204,6 +15209,11 @@ components:
15204
15209
type:
15205
15210
- 'string'
15206
15211
- 'null'
15212
+
icon_sha256:
15213
+
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`.'
15214
+
type:
15215
+
- 'string'
15216
+
- 'null'
15207
15217
id:
15208
15218
description: 'Intern id.'
15209
15219
type: 'string'
@@ -15953,8 +15963,10 @@ components:
15953
15963
data:
15954
15964
- attached_vault_id: null
15955
15965
created_at: '2026-09-16T08:30:00.000Z'
15966
+
created_by_you: true
15956
15967
description: 'Researches customer questions'
15957
15968
hostname: 'research-assistant.openrouter.ai'
15969
+
icon_sha256: null
15958
15970
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
15959
15971
instructions: null
15960
15972
last_failure_message: null
@@ -42439,8 +42451,10 @@ paths:
42439
42451
data:
42440
42452
- attached_vault_id: null
42441
42453
created_at: '2026-09-16T08:30:00.000Z'
42454
+
created_by_you: true
42442
42455
description: 'Researches customer questions'
42443
42456
hostname: 'research-assistant.openrouter.ai'
42457
+
icon_sha256: null
42444
42458
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
42445
42459
instructions: null
42446
42460
last_failure_message: null
@@ -42563,8 +42577,10 @@ paths:
42563
42577
example:
42564
42578
attached_vault_id: null
42565
42579
created_at: '2026-09-16T08:30:00.000Z'
42580
+
created_by_you: true
42566
42581
description: 'Researches customer questions'
42567
42582
hostname: 'research-assistant.openrouter.ai'
42583
+
icon_sha256: null
42568
42584
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
42569
42585
instructions: null
42570
42586
last_failure_message: null
@@ -42584,8 +42600,10 @@ paths:
42584
42600
example:
42585
42601
attached_vault_id: null
42586
42602
created_at: '2026-09-16T08:30:00.000Z'
42603
+
created_by_you: true
42587
42604
description: 'Researches customer questions'
42588
42605
hostname: 'research-assistant.openrouter.ai'
42606
+
icon_sha256: null
42589
42607
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
42590
42608
instructions: null
42591
42609
last_failure_message: null
@@ -42935,8 +42953,10 @@ paths:
42935
42953
example:
42936
42954
attached_vault_id: null
42937
42955
created_at: '2026-09-16T08:30:00.000Z'
42956
+
created_by_you: true
42938
42957
description: 'Researches customer questions'
42939
42958
hostname: 'research-assistant.openrouter.ai'
42959
+
icon_sha256: null
42940
42960
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
42941
42961
instructions: null
42942
42962
last_failure_message: null
@@ -43043,8 +43063,10 @@ paths:
43043
43063
example:
43044
43064
attached_vault_id: null
43045
43065
created_at: '2026-09-16T08:30:00.000Z'
43066
+
created_by_you: true
43046
43067
description: 'Researches customer questions'
43047
43068
hostname: 'research-assistant.openrouter.ai'
43069
+
icon_sha256: null
43048
43070
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
43049
43071
instructions: null
43050
43072
last_failure_message: null
@@ -43944,6 +43966,107 @@ paths:
43944
43966
- $ref: "#/components/parameters/AppIdentifier"
43945
43967
- $ref: "#/components/parameters/AppDisplayName"
43946
43968
- $ref: "#/components/parameters/AppCategories"
43969
+
/interns/{internId}/icon:
43970
+
get:
43971
+
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.'
43972
+
operationId: 'getInternIcon'
43973
+
parameters:
43974
+
- description: 'ID of an intern visible to the authenticated API key.'
43975
+
in: 'path'
43976
+
name: 'internId'
43977
+
required: true
43978
+
schema:
43979
+
description: 'ID of an intern visible to the authenticated API key.'
43980
+
example: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
43981
+
minLength: 1
43982
+
type: 'string'
43983
+
- description: 'The `icon_sha256` the caller expects.'
43984
+
in: 'query'
43985
+
name: 'v'
43986
+
required: false
43987
+
schema:
43988
+
description: 'The `icon_sha256` the caller expects.'
43989
+
type: 'string'
43990
+
responses:
43991
+
'200':
43992
+
content:
43993
+
image/jpeg:
43994
+
schema:
43995
+
format: 'binary'
43996
+
type: 'string'
43997
+
image/png:
43998
+
schema:
43999
+
format: 'binary'
44000
+
type: 'string'
44001
+
description: 'Icon image bytes.'
44002
+
'401':
44003
+
content:
44004
+
application/json:
44005
+
example:
44006
+
error:
44007
+
code: 401
44008
+
message: 'Invalid or missing API key'
44009
+
schema:
44010
+
$ref: '#/components/schemas/InternLifecycleError'
44011
+
description: 'Missing, unknown or provisioning API key.'
44012
+
'403':
44013
+
content:
44014
+
application/json:
44015
+
example:
44016
+
error:
44017
+
code: 403
44018
+
message: 'Forbidden'
44019
+
schema:
44020
+
$ref: '#/components/schemas/InternLifecycleError'
44021
+
description: 'The key owner no longer has access, or the request used a regional hostname.'
44022
+
'404':
44023
+
content:
44024
+
application/json:
44025
+
example:
44026
+
error:
44027
+
code: 404
44028
+
message: 'Intern not found'
44029
+
metadata:
44030
+
reason: 'not_found'
44031
+
retryable: false
44032
+
schema:
44033
+
$ref: '#/components/schemas/InternLifecycleError'
44034
+
description: 'The caller is outside the Intern API programme, the intern is hidden, or lifecycle writes are disabled.'
44035
+
'408':
44036
+
content:
44037
+
application/json:
44038
+
example:
44039
+
error:
44040
+
code: 408
44041
+
message: 'Operation timed out after 10s. Please try again later.'
44042
+
metadata:
44043
+
reason: 'timeout'
44044
+
retryable: true
44045
+
schema:
44046
+
$ref: '#/components/schemas/InternLifecycleError'
44047
+
description: 'The request exceeded its route deadline. The deadline quoted in the message is the route''s own, so it differs between operations.'
44048
+
'500':
44049
+
content:
44050
+
application/json:
44051
+
example:
44052
+
error:
44053
+
code: 500
44054
+
message: 'The request could not be completed'
44055
+
metadata:
44056
+
reason: 'internal_error'
44057
+
retryable: true
44058
+
schema:
44059
+
$ref: '#/components/schemas/InternLifecycleError'
44060
+
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.'
44061
+
security:
44062
+
- apiKey: []
44063
+
summary: 'Get an intern''s icon'
44064
+
tags:
44065
+
- 'Interns'
44066
+
parameters:
44067
+
- $ref: "#/components/parameters/AppIdentifier"
44068
+
- $ref: "#/components/parameters/AppDisplayName"
44069
+
- $ref: "#/components/parameters/AppCategories"
43947
44070
/interns/{internId}/invoke:
43948
44071
post:
43949
44072
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