Delete an intern

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. A non-empty body must declare Content-Type: application/json or it is refused with 415. 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 required.

delete/interns/{internId}

Path parameters

internIdstring required

ID of an intern visible to the authenticated API key.

Example:7c9e6679-7425-40de-944b-e07fc1f90ae7

ID of an intern visible to the authenticated API key.

Request body

acknowledge_workspace_lossboolean

Delete even though the workspace backup was not confirmed. Defaults to false, which refuses the teardown when a workspace archive is missing.

Example request

{
  "acknowledge_workspace_loss": true
}

Response

The operation was accepted.

deletingtrue required

Changes

Changed in 4 of the 303 revisions of this API.113

Sep 21, 20260ca3cbfb629d1See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
Sep 21, 202650d23050da7a9See the full diff
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Sep 19, 20261212b12392a812See the full diff
- ▲
  added required request body
  request-body-added-required
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
Sep 17, 2026c3b9702bd9d71See the full diff
- ○
  endpoint added
  endpoint-added

Full history