Interns

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