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 35042ec
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: .speakeasy/out.openapi.yaml
+258-2Lines changed: 258 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -15173,6 +15173,7 @@ components:
15173
15173
description: 'Public lifecycle state and settings for one intern.'
15174
15174
example:
15175
15175
attached_vault_id: null
15176
+
can_edit: true
15176
15177
created_at: '2026-09-16T08:30:00.000Z'
15177
15178
created_by_you: true
15178
15179
description: 'Researches customer questions'
@@ -15194,6 +15195,9 @@ components:
15194
15195
type:
15195
15196
- 'string'
15196
15197
- 'null'
15198
+
can_edit:
15199
+
description: 'Whether this key may change the intern (update, provision, suspend, delete). Present on list and retrieve; false while lifecycle writes are closed for the account.'
15200
+
type: 'boolean'
15197
15201
created_at:
15198
15202
description: 'ISO 8601 creation time.'
15199
15203
type: 'string'
@@ -15861,6 +15865,139 @@ components:
15861
15865
- 'content'
15862
15866
- 'role'
15863
15867
type: 'object'
15868
+
InternConnection:
15869
+
properties:
15870
+
account:
15871
+
properties:
15872
+
acts_as:
15873
+
description: 'Whose account it acts as, when known.'
15874
+
type:
15875
+
- 'string'
15876
+
- 'null'
15877
+
is_your_account_linked:
15878
+
type:
15879
+
- 'boolean'
15880
+
- 'null'
15881
+
note:
15882
+
type:
15883
+
- 'string'
15884
+
- 'null'
15885
+
scope:
15886
+
description: '`workspace` for a shared connection, `yours` for the key user''s personal account, `shared` for a teammate''s.'
15887
+
enum:
15888
+
- 'workspace'
15889
+
- 'yours'
15890
+
- 'shared'
15891
+
type: 'string'
15892
+
x-speakeasy-unknown-values: allow
15893
+
required:
15894
+
- 'acts_as'
15895
+
- 'is_your_account_linked'
15896
+
- 'note'
15897
+
- 'scope'
15898
+
type: 'object'
15899
+
id:
15900
+
description: 'Stable id: the credential id of an MCP server, else the kind (`slack`, `github`, `google`).'
15901
+
type: 'string'
15902
+
is_enabled:
15903
+
description: 'Whether the intern reaches it now.'
15904
+
type: 'boolean'
15905
+
is_intern_only:
15906
+
description: 'Scoped to this intern rather than shared by the workspace.'
15907
+
type: 'boolean'
15908
+
kind:
15909
+
enum:
15910
+
- 'slack'
15911
+
- 'github'
15912
+
- 'google'
15913
+
- 'mcp'
15914
+
type: 'string'
15915
+
x-speakeasy-unknown-values: allow
15916
+
mcp_server_name:
15917
+
description: 'The name the intern''s MCP config keys the server by; null when it is not an MCP server or is off.'
15918
+
type:
15919
+
- 'string'
15920
+
- 'null'
15921
+
name:
15922
+
description: 'Display name.'
15923
+
type: 'string'
15924
+
off_reason:
15925
+
description: '`switched_off` for this intern, `disabled` for the whole workspace; null while on.'
15926
+
enum:
15927
+
- 'switched_off'
15928
+
- 'disabled'
15929
+
- null
15930
+
type:
15931
+
- 'string'
15932
+
- 'null'
15933
+
x-speakeasy-unknown-values: allow
15934
+
server:
15935
+
properties:
15936
+
host:
15937
+
type:
15938
+
- 'string'
15939
+
- 'null'
15940
+
surface:
15941
+
type: 'string'
15942
+
transport:
15943
+
type: 'string'
15944
+
url:
15945
+
type:
15946
+
- 'string'
15947
+
- 'null'
15948
+
required:
15949
+
- 'host'
15950
+
- 'surface'
15951
+
- 'transport'
15952
+
- 'url'
15953
+
type:
15954
+
- 'object'
15955
+
- 'null'
15956
+
status:
15957
+
properties:
15958
+
reason:
15959
+
type:
15960
+
- 'string'
15961
+
- 'null'
15962
+
state:
15963
+
enum:
15964
+
- 'connected'
15965
+
- 'needs_reconnect'
15966
+
- 'not_tested'
15967
+
- 'error'
15968
+
type: 'string'
15969
+
x-speakeasy-unknown-values: allow
15970
+
required:
15971
+
- 'state'
15972
+
- 'reason'
15973
+
type: 'object'
15974
+
tool_count:
15975
+
description: 'Tools found by the last successful test.'
15976
+
type:
15977
+
- 'integer'
15978
+
- 'null'
15979
+
required:
15980
+
- 'id'
15981
+
- 'kind'
15982
+
- 'name'
15983
+
- 'is_enabled'
15984
+
- 'is_intern_only'
15985
+
- 'off_reason'
15986
+
- 'mcp_server_name'
15987
+
- 'server'
15988
+
- 'status'
15989
+
- 'tool_count'
15990
+
- 'account'
15991
+
type: 'object'
15992
+
InternConnectionList:
15993
+
properties:
15994
+
data:
15995
+
items:
15996
+
$ref: '#/components/schemas/InternConnection'
15997
+
type: 'array'
15998
+
required:
15999
+
- 'data'
16000
+
type: 'object'
15864
16001
InternDaemonAccess:
15865
16002
description: 'The intern daemon''s origin and the bearer `ori tui --host` sends to it as `ORI_DAEMON_TOKEN`.'
15866
16003
example:
@@ -15963,6 +16100,7 @@ components:
15963
16100
example:
15964
16101
data:
15965
16102
- attached_vault_id: null
16103
+
can_edit: true
15966
16104
created_at: '2026-09-16T08:30:00.000Z'
15967
16105
created_by_you: true
15968
16106
description: 'Researches customer questions'
@@ -26469,21 +26607,26 @@ components:
26469
26607
- 'data'
26470
26608
type: 'object'
26471
26609
PromptCacheBreakpoint:
26472
-
description: 'Marks an explicit prompt-cache boundary on this content block (OpenAI-style). Everything through the block carrying this marker is part of the candidate cached prefix. Supported natively by OpenAI GPT-5.6 and newer; on providers that use Anthropic-style `cache_control`, OpenRouter converts the marker to that format automatically.'
26610
+
description: 'Marks an explicit prompt-cache boundary on this content block (OpenAI-style). Everything through the block carrying this marker is part of the candidate cached prefix. Supported natively by OpenAI GPT-5.6 and newer; on providers that use Anthropic-style `cache_control`, OpenRouter converts the marker to that format automatically. `ttl` ("30m" or "12h") overrides the request-level `prompt_cache_options.ttl` for this boundary; 12h writes bill at the higher cache-write rate.'
26473
26611
example:
26474
26612
mode: 'explicit'
26613
+
ttl: '30m'
26475
26614
properties:
26476
26615
mode:
26477
26616
enum:
26478
26617
- 'explicit'
26479
26618
type: 'string'
26619
+
ttl:
26620
+
type:
26621
+
- 'string'
26622
+
- 'null'
26480
26623
required:
26481
26624
- 'mode'
26482
26625
type:
26483
26626
- 'object'
26484
26627
- 'null'
26485
26628
PromptCacheOptions:
26486
-
description: 'Request-level prompt-cache controls. `mode: "explicit"` disables OpenAI-managed breakpoints so only blocks marked with `prompt_cache_breakpoint` are cached. Only supported by OpenAI GPT-5.6 and newer.'
26629
+
description: 'Request-level prompt-cache controls. `mode: "explicit"` disables OpenAI-managed breakpoints so only blocks marked with `prompt_cache_breakpoint` are cached. `ttl` sets the minimum cache lifetime for every breakpoint the request writes: "30m" (default) or "12h" (billed at the higher 12h cache-write rate). Only supported by OpenAI GPT-5.6 and newer.'
26487
26630
example:
26488
26631
mode: 'explicit'
26489
26632
ttl: '30m'
@@ -42463,6 +42606,7 @@ paths:
42463
42606
example:
42464
42607
data:
42465
42608
- attached_vault_id: null
42609
+
can_edit: true
42466
42610
created_at: '2026-09-16T08:30:00.000Z'
42467
42611
created_by_you: true
42468
42612
description: 'Researches customer questions'
@@ -42589,6 +42733,7 @@ paths:
42589
42733
application/json:
42590
42734
example:
42591
42735
attached_vault_id: null
42736
+
can_edit: true
42592
42737
created_at: '2026-09-16T08:30:00.000Z'
42593
42738
created_by_you: true
42594
42739
description: 'Researches customer questions'
@@ -42612,6 +42757,7 @@ paths:
42612
42757
application/json:
42613
42758
example:
42614
42759
attached_vault_id: null
42760
+
can_edit: true
42615
42761
created_at: '2026-09-16T08:30:00.000Z'
42616
42762
created_by_you: true
42617
42763
description: 'Researches customer questions'
@@ -42965,6 +43111,7 @@ paths:
42965
43111
application/json:
42966
43112
example:
42967
43113
attached_vault_id: null
43114
+
can_edit: true
42968
43115
created_at: '2026-09-16T08:30:00.000Z'
42969
43116
created_by_you: true
42970
43117
description: 'Researches customer questions'
@@ -43075,6 +43222,7 @@ paths:
43075
43222
application/json:
43076
43223
example:
43077
43224
attached_vault_id: null
43225
+
can_edit: true
43078
43226
created_at: '2026-09-16T08:30:00.000Z'
43079
43227
created_by_you: true
43080
43228
description: 'Researches customer questions'
@@ -43457,6 +43605,114 @@ paths:
43457
43605
- $ref: "#/components/parameters/AppIdentifier"
43458
43606
- $ref: "#/components/parameters/AppDisplayName"
43459
43607
- $ref: "#/components/parameters/AppCategories"
43608
+
/interns/{internId}/connections:
43609
+
get:
43610
+
description: 'Returns the Slack, GitHub, Google Workspace and MCP connections one visible intern can reach, and the shared ones switched off for it or disabled for the workspace. An OAuth grant needs `vault:read`, because the list names members'' personal accounts; without it the route answers 403 `insufficient_scope`. The response is sent with `Cache-Control: no-store`. 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.'
43611
+
operationId: 'getInternConnections'
43612
+
parameters:
43613
+
- description: 'ID of an intern visible to the authenticated API key.'
43614
+
in: 'path'
43615
+
name: 'internId'
43616
+
required: true
43617
+
schema:
43618
+
description: 'ID of an intern visible to the authenticated API key.'
43619
+
example: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
43620
+
minLength: 1
43621
+
type: 'string'
43622
+
responses:
43623
+
'200':
43624
+
content:
43625
+
application/json:
43626
+
example:
43627
+
data:
43628
+
- account:
43629
+
acts_as: null
43630
+
is_your_account_linked: null
43631
+
note: null
43632
+
scope: 'workspace'
43633
+
id: 'github'
43634
+
is_enabled: true
43635
+
is_intern_only: false
43636
+
kind: 'github'
43637
+
mcp_server_name: null
43638
+
name: 'GitHub'
43639
+
off_reason: null
43640
+
server: null
43641
+
status:
43642
+
reason: null
43643
+
state: 'connected'
43644
+
tool_count: null
43645
+
schema:
43646
+
$ref: '#/components/schemas/InternConnectionList'
43647
+
description: 'The intern connections.'
43648
+
'401':
43649
+
content:
43650
+
application/json:
43651
+
example:
43652
+
error:
43653
+
code: 401
43654
+
message: 'Invalid or missing API key'
43655
+
schema:
43656
+
$ref: '#/components/schemas/InternLifecycleError'
43657
+
description: 'Missing, unknown or provisioning API key.'
43658
+
'403':
43659
+
content:
43660
+
application/json:
43661
+
example:
43662
+
error:
43663
+
code: 403
43664
+
message: 'Forbidden'
43665
+
schema:
43666
+
$ref: '#/components/schemas/InternLifecycleError'
43667
+
description: 'The key owner no longer has access, or the request used a regional hostname.'
43668
+
'404':
43669
+
content:
43670
+
application/json:
43671
+
example:
43672
+
error:
43673
+
code: 404
43674
+
message: 'Intern not found'
43675
+
metadata:
43676
+
reason: 'not_found'
43677
+
retryable: false
43678
+
schema:
43679
+
$ref: '#/components/schemas/InternLifecycleError'
43680
+
description: 'The caller is outside the Intern API programme, the intern is hidden, or lifecycle writes are disabled.'
43681
+
'408':
43682
+
content:
43683
+
application/json:
43684
+
example:
43685
+
error:
43686
+
code: 408
43687
+
message: 'Operation timed out after 10s. Please try again later.'
43688
+
metadata:
43689
+
reason: 'timeout'
43690
+
retryable: true
43691
+
schema:
43692
+
$ref: '#/components/schemas/InternLifecycleError'
43693
+
description: 'The request exceeded its route deadline. The deadline quoted in the message is the route''s own, so it differs between operations.'
43694
+
'500':
43695
+
content:
43696
+
application/json:
43697
+
example:
43698
+
error:
43699
+
code: 500
43700
+
message: 'The request could not be completed'
43701
+
metadata:
43702
+
reason: 'internal_error'
43703
+
retryable: true
43704
+
schema:
43705
+
$ref: '#/components/schemas/InternLifecycleError'
43706
+
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.'
43707
+
security:
43708
+
- apiKey: []
43709
+
summary: 'List an intern''s connections'
43710
+
tags:
43711
+
- 'Interns'
43712
+
parameters:
43713
+
- $ref: "#/components/parameters/AppIdentifier"
43714
+
- $ref: "#/components/parameters/AppDisplayName"
43715
+
- $ref: "#/components/parameters/AppCategories"
43460
43716
/interns/{internId}/daemon:
43461
43717
get:
43462
43718
description: 'Returns the origin and daemon token that attach `ori tui --host` to one visible, running intern. The token is a credential: only an OAuth-token caller (`ori login --oidc`) may read it, the response is sent with `Cache-Control: no-store`, and each reveal is logged by caller and intern. API keys get 403 `personal_identity_required`. 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.'
0 commit comments