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
Copy file name to clipboardExpand all lines: .speakeasy/out.openapi.yaml
+48-7Lines changed: 48 additions & 7 deletions
Original file line number
Diff line number
Diff line change
@@ -8600,6 +8600,17 @@ components:
8600
8600
required:
8601
8601
- 'deleted'
8602
8602
type: 'object'
8603
+
DeleteInternRequest:
8604
+
additionalProperties: false
8605
+
description: 'Optional consent for a teardown that discards the workspace.'
8606
+
example:
8607
+
acknowledge_workspace_loss: true
8608
+
properties:
8609
+
acknowledge_workspace_loss:
8610
+
default: false
8611
+
description: 'Delete even though the workspace backup was not confirmed. Defaults to false, which refuses the teardown when a workspace archive is missing.'
description: 'The request `model` when given, or `openrouter/intern`. The final chunk may carry the model the intern reported for the run instead.'
12627
+
description: 'The runtime''s identifier for the model the intern is running, as the intern reports it. Each chunk carries the model from the event behind it: `openrouter/intern` on chunks emitted before the intern has reported one and on chunks the API emits itself (timeout, run-ended and severed-stream errors and their final usage chunk), even after an earlier chunk named a model. It can change within a stream. It is not an OpenRouter model slug, and the request `model` is never used.'
12617
12628
type: 'string'
12618
12629
object:
12619
12630
enum:
12620
12631
- 'chat.completion.chunk'
12621
12632
type: 'string'
12622
12633
session_id:
12623
-
description: 'On the final chunk of every response, the daemon session to continue with, or `null` when the run failed before the intern reported one. Send it as `session_id` on the next request, including the `tool` reply to an interaction.'
12634
+
description: 'On the final chunk of every response, the daemon session to continue with, or `null` when the run failed before the intern reported one. Send it as `session_id` on the next request, including the `tool` reply to an interaction. Session ids are client-visible and scoped to the intern''s own daemon.'
12624
12635
example: 'ses_7f3c9a'
12625
12636
type:
12626
12637
- 'string'
@@ -12652,20 +12663,20 @@ components:
12652
12663
minItems: 1
12653
12664
type: 'array'
12654
12665
model:
12655
-
description: 'Accepted for OpenAI compatibility and ignored. Streamed chunks report the model the intern actually used, or `openrouter/intern` when it did not report one.'
12666
+
description: 'Accepted for OpenAI compatibility and never used. The intern runs the model configured on it (`PATCH` the intern to change it). Streamed chunks report the runtime''s identifier for that model as the intern reports it, or `openrouter/intern` on chunks whose event carries no model (before the intern reports one, and on the chunks the API emits itself: the timeout, run-ended and severed-stream error chunks, the stop chunk of a replay that ends without a terminal daemon event, and the final usage chunk after any of them). A usage chunk that follows a daemon completion event carries the model the intern reported.'
12656
12667
example: 'openrouter/intern'
12657
12668
maxLength: 256
12658
12669
minLength: 1
12659
12670
type: 'string'
12660
12671
session_id:
12661
-
description: 'The daemon session to continue, as returned in `session_id` on the final chunk of an earlier response. Omit it to start a new session. Required when the last message has role `tool`.'
12672
+
description: 'The daemon session to continue, as returned in `session_id` on the final chunk of an earlier response. Omit it to start a new session. An id the intern has not seen before is not an error: it starts a new session under that id, so a mistyped id forks the conversation. Sessions are scoped to the intern''s own daemon. Required when the last message has role `tool`.'
12662
12673
example: 'ses_7f3c9a'
12663
12674
maxLength: 256
12664
12675
minLength: 1
12665
12676
type: 'string'
12666
12677
stream:
12667
12678
const: true
12668
-
description: 'Must be `true`. This endpoint only streams.'
12679
+
description: 'Must be `true`. This endpoint only streams. `false` or an omitted `stream` is refused with `400` and reason `bad_request`.'
12669
12680
example: true
12670
12681
type: 'boolean'
12671
12682
required:
@@ -28003,8 +28014,10 @@ components:
28003
28014
- 'string'
28004
28015
- 'null'
28005
28016
model:
28006
-
description: 'New OpenRouter model slug. Null restores the workspace default.'
28017
+
description: 'New OpenRouter model slug in `author/slug` form (an optional `:variant` suffix is accepted). Other shapes are refused with 400. Null restores the workspace default. Takes effect on the next provision: until then `GET` shows this configured model while chat chunks show the model the running intern reports.'
description: 'Starts safe teardown of the intern, its runtime and its private vault. 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.'
36640
+
description: 'Starts safe teardown of the intern, its runtime and its private vault. The body is optional. Send `{"acknowledge_workspace_loss": true}` to delete a `destroy_failed` intern whose `last_failure_message` names `workspace_archive_failed`, accepting that its workspace is not backed up. The request body is capped at 1048576 bytes and a larger body is refused with 413. 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.'
36628
36641
operationId: 'deleteIntern'
36629
36642
parameters:
36630
36643
- description: 'ID of an intern visible to the authenticated API key.'
@@ -36636,6 +36649,14 @@ paths:
36636
36649
example: '7c9e6679-7425-40de-944b-e07fc1f90ae7'
36637
36650
minLength: 1
36638
36651
type: 'string'
36652
+
requestBody:
36653
+
content:
36654
+
application/json:
36655
+
example:
36656
+
acknowledge_workspace_loss: true
36657
+
schema:
36658
+
$ref: '#/components/schemas/DeleteInternRequest'
36659
+
required: true
36639
36660
responses:
36640
36661
'202':
36641
36662
content:
@@ -36645,6 +36666,16 @@ paths:
36645
36666
schema:
36646
36667
$ref: '#/components/schemas/DeleteInternResponse'
36647
36668
description: 'The operation was accepted.'
36669
+
'400':
36670
+
content:
36671
+
application/json:
36672
+
example:
36673
+
error:
36674
+
code: 'invalid_body'
36675
+
message: 'Invalid request body'
36676
+
schema:
36677
+
$ref: '#/components/schemas/InternLifecycleError'
36678
+
description: 'The request body is invalid.'
36648
36679
'401':
36649
36680
content:
36650
36681
application/json:
@@ -36695,6 +36726,16 @@ paths:
36695
36726
schema:
36696
36727
$ref: '#/components/schemas/InternLifecycleError'
36697
36728
description: 'The intern is not in a state that allows this operation.'
36729
+
'413':
36730
+
content:
36731
+
application/json:
36732
+
example:
36733
+
error:
36734
+
code: 'payload_too_large'
36735
+
message: 'Request body exceeds 1048576 bytes'
36736
+
schema:
36737
+
$ref: '#/components/schemas/InternLifecycleError'
36738
+
description: 'The request body is larger than 1048576 bytes.'
0 commit comments