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 0373c01
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: .speakeasy/in.openapi.yaml
+119Lines changed: 119 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -15039,8 +15039,10 @@ components:
15039
15039
example:
15040
15040
attached_vault_id: null
15041
15041
created_at: '2026-09-16T08:30:00.000Z'
15042
+
created_by_you: true
15042
15043
description: 'Researches customer questions'
15043
15044
hostname: 'research-assistant.openrouter.ai'
15045
+
icon_sha256: null
15044
15046
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
15045
15047
instructions: null
15046
15048
last_failure_message: null
@@ -15060,6 +15062,9 @@ components:
15060
15062
created_at:
15061
15063
description: 'ISO 8601 creation time.'
15062
15064
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'
15063
15068
description:
15064
15069
description: 'Free-form description.'
15065
15070
type:
@@ -15070,6 +15075,11 @@ components:
15070
15075
type:
15071
15076
- 'string'
15072
15077
- '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'
15073
15083
id:
15074
15084
description: 'Intern id.'
15075
15085
type: 'string'
@@ -15814,8 +15824,10 @@ components:
15814
15824
data:
15815
15825
- attached_vault_id: null
15816
15826
created_at: '2026-09-16T08:30:00.000Z'
15827
+
created_by_you: true
15817
15828
description: 'Researches customer questions'
15818
15829
hostname: 'research-assistant.openrouter.ai'
15830
+
icon_sha256: null
15819
15831
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
15820
15832
instructions: null
15821
15833
last_failure_message: null
@@ -41956,8 +41968,10 @@ paths:
41956
41968
data:
41957
41969
- attached_vault_id: null
41958
41970
created_at: '2026-09-16T08:30:00.000Z'
41971
+
created_by_you: true
41959
41972
description: 'Researches customer questions'
41960
41973
hostname: 'research-assistant.openrouter.ai'
41974
+
icon_sha256: null
41961
41975
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
41962
41976
instructions: null
41963
41977
last_failure_message: null
@@ -42080,8 +42094,10 @@ paths:
42080
42094
example:
42081
42095
attached_vault_id: null
42082
42096
created_at: '2026-09-16T08:30:00.000Z'
42097
+
created_by_you: true
42083
42098
description: 'Researches customer questions'
42084
42099
hostname: 'research-assistant.openrouter.ai'
42100
+
icon_sha256: null
42085
42101
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
42086
42102
instructions: null
42087
42103
last_failure_message: null
@@ -42101,8 +42117,10 @@ paths:
42101
42117
example:
42102
42118
attached_vault_id: null
42103
42119
created_at: '2026-09-16T08:30:00.000Z'
42120
+
created_by_you: true
42104
42121
description: 'Researches customer questions'
42105
42122
hostname: 'research-assistant.openrouter.ai'
42123
+
icon_sha256: null
42106
42124
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
42107
42125
instructions: null
42108
42126
last_failure_message: null
@@ -42448,8 +42466,10 @@ paths:
42448
42466
example:
42449
42467
attached_vault_id: null
42450
42468
created_at: '2026-09-16T08:30:00.000Z'
42469
+
created_by_you: true
42451
42470
description: 'Researches customer questions'
42452
42471
hostname: 'research-assistant.openrouter.ai'
42472
+
icon_sha256: null
42453
42473
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
42454
42474
instructions: null
42455
42475
last_failure_message: null
@@ -42556,8 +42576,10 @@ paths:
42556
42576
example:
42557
42577
attached_vault_id: null
42558
42578
created_at: '2026-09-16T08:30:00.000Z'
42579
+
created_by_you: true
42559
42580
description: 'Researches customer questions'
42560
42581
hostname: 'research-assistant.openrouter.ai'
42582
+
icon_sha256: null
42561
42583
id: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
42562
42584
instructions: null
42563
42585
last_failure_message: null
@@ -43430,6 +43452,103 @@ paths:
43430
43452
summary: 'Sign a daemon request with the caller''s identity'
43431
43453
tags:
43432
43454
- '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'
43433
43552
/interns/{internId}/invoke:
43434
43553
post:
43435
43554
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