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 4a28cc2
Browse filesBrowse the repository at this point in the historyBrowse files
description: 'The intern admitted the prompt. The run continues on the intern.'
13233
13249
example:
@@ -37788,6 +37804,121 @@ paths:
37788
37804
- $ref: "#/components/parameters/AppIdentifier"
37789
37805
- $ref: "#/components/parameters/AppDisplayName"
37790
37806
- $ref: "#/components/parameters/AppCategories"
37807
+
/interns/{internId}/daemon-access:
37808
+
get:
37809
+
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.'
37810
+
operationId: 'getInternDaemonAccess'
37811
+
parameters:
37812
+
- description: 'ID of an intern visible to the authenticated API key.'
37813
+
in: 'path'
37814
+
name: 'internId'
37815
+
required: true
37816
+
schema:
37817
+
description: 'ID of an intern visible to the authenticated API key.'
37818
+
example: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
37819
+
minLength: 1
37820
+
type: 'string'
37821
+
responses:
37822
+
'200':
37823
+
content:
37824
+
application/json:
37825
+
schema:
37826
+
$ref: '#/components/schemas/InternDaemonAccess'
37827
+
description: 'Daemon origin and token.'
37828
+
'401':
37829
+
content:
37830
+
application/json:
37831
+
example:
37832
+
error:
37833
+
code: 401
37834
+
message: 'Invalid or missing API key'
37835
+
schema:
37836
+
$ref: '#/components/schemas/InternLifecycleError'
37837
+
description: 'Missing, unknown or provisioning API key.'
37838
+
'403':
37839
+
content:
37840
+
application/json:
37841
+
example:
37842
+
error:
37843
+
code: 403
37844
+
message: 'Forbidden'
37845
+
schema:
37846
+
$ref: '#/components/schemas/InternLifecycleError'
37847
+
description: 'The key owner no longer has access, or the request used a regional hostname.'
37848
+
'404':
37849
+
content:
37850
+
application/json:
37851
+
example:
37852
+
error:
37853
+
code: 404
37854
+
message: 'Intern not found'
37855
+
metadata:
37856
+
reason: 'not_found'
37857
+
retryable: false
37858
+
schema:
37859
+
$ref: '#/components/schemas/InternLifecycleError'
37860
+
description: 'The caller is outside the Intern API programme, the intern is hidden, or lifecycle writes are disabled.'
37861
+
'408':
37862
+
content:
37863
+
application/json:
37864
+
example:
37865
+
error:
37866
+
code: 408
37867
+
message: 'Operation timed out after 10s. Please try again later.'
37868
+
metadata:
37869
+
reason: 'timeout'
37870
+
retryable: true
37871
+
schema:
37872
+
$ref: '#/components/schemas/InternLifecycleError'
37873
+
description: 'The request exceeded its route deadline. The deadline quoted in the message is the route''s own, so it differs between operations.'
37874
+
'409':
37875
+
content:
37876
+
application/json:
37877
+
example:
37878
+
error:
37879
+
code: 409
37880
+
message: 'This intern is not running.'
37881
+
metadata:
37882
+
reason: 'intern_not_running'
37883
+
retryable: false
37884
+
schema:
37885
+
$ref: '#/components/schemas/InternLifecycleError'
37886
+
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.'
37887
+
'429':
37888
+
content:
37889
+
application/json:
37890
+
example:
37891
+
error:
37892
+
code: 429
37893
+
message: 'Too many token reveals. Please wait a moment.'
37894
+
metadata:
37895
+
reason: 'rate_limited'
37896
+
retryable: true
37897
+
schema:
37898
+
$ref: '#/components/schemas/InternLifecycleError'
37899
+
description: 'The caller made more than 10 reveals in the last minute. Wait for `Retry-After` seconds.'
37900
+
'500':
37901
+
content:
37902
+
application/json:
37903
+
example:
37904
+
error:
37905
+
code: 500
37906
+
message: 'The request could not be completed'
37907
+
metadata:
37908
+
reason: 'internal_error'
37909
+
retryable: true
37910
+
schema:
37911
+
$ref: '#/components/schemas/InternLifecycleError'
37912
+
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.'
37913
+
security:
37914
+
- apiKey: []
37915
+
summary: 'Get an intern''s daemon access'
37916
+
tags:
37917
+
- 'Interns'
37918
+
parameters:
37919
+
- $ref: "#/components/parameters/AppIdentifier"
37920
+
- $ref: "#/components/parameters/AppDisplayName"
37921
+
- $ref: "#/components/parameters/AppCategories"
37791
37922
/interns/{internId}/invoke:
37792
37923
post:
37793
37924
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