sandboxes

Delete a sandbox: stop it, delete its disk and paused memory, revoke its previews and ports, and remove it from lists.

Works in any state. Billing ends as a stop's does; a kept disk is billed until its host confirms the deletion, usually seconds. Its snapshots stay (delete them apart), and its usage, charges and audit entries stay. After it the sandbox reads nowhere: GET answers not_found. Deleting it again answers the same.

delete/v1/sandboxes/{id}

Request

  • Base URL: https://api.withruntime.com
  • URL: https://api.withruntime.com/v1/sandboxes/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Resource identifier (UUID).

Headers

Idempotency-Keystring

Replaying the same key with the same request within 24 hours returns the first result and never repeats the effect. A refusal is not kept: a request refused before it ran (no_capacity, busy, a limit) runs afresh when sent again with its key. The SDKs send one automatically; the server makes one when absent and returns it in the idempotency-key response header.

Response

Success

idstring required

Resource identifier (UUID).

kind'sandbox' required
namestring nullable
labelsobject

Your own key/value tags, at most 32. Filter lists with label=key:value.

status'deleted' required
statestring required

stopping until its machine has stopped, usually well under a second; then stopped.

deletedAtstring date-time required
endedAtstring date-time nullable
replayedboolean

Changes

No recorded changes to this operation across all 1 revision of this API.