Leap0

Pause a sandbox

Pause a running sandbox. The sandbox's VM state, memory, and disk are captured and uploaded, the sandbox is marked as paused, and the VM is terminated. The sandbox can later be resumed via the invoke route or the resume endpoint, which restores it from the saved state. Unlike `POST /snapshot/create` with `kill_sandbox_after`, this does **not** create a named snapshot.

POST
/v1/sandbox/{sandboxID}/pause

Pause a running sandbox. The sandbox's VM state, memory, and disk are captured and uploaded, the sandbox is marked as paused, and the VM is terminated. The sandbox can later be resumed via the invoke route or the resume endpoint, which restores it from the saved state. Unlike POST /snapshot/create with kill_sandbox_after, this does not create a named snapshot.

Authorization

BearerAuth
AuthorizationBearer <token>

API key passed as a Bearer token in the Authorization header. Alternatively, use the leap0-authorization header.

In: header

Path Parameters

sandboxID*string

Unique sandbox identifier.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://api.leap0.dev/v1/sandbox/string/pause"
{  "id": "sbx-abc123",  "template_id": "string",  "mounts": [    {      "id": "mnt-abc123",      "type": "object-storage",      "bucket": "string",      "mount_path": "string",      "prefix": "string",      "read_only": true    }  ],  "vcpu": 1,  "memory": 1,  "disk": 1,  "timeout": 1,  "state": "starting",  "auto_pause": true,  "network_policy": {    "mode": "allow-all",    "allow_domains": [      "string"    ],    "allow_cidrs": [      "string"    ],    "transforms": [      {        "domain": "string",        "inject_headers": {          "property1": "string",          "property2": "string"        },        "strip_headers": [          "string"        ]      }    ]  },  "created_at": "2019-08-24T14:15:22Z"}
{  "message": "string"}
{  "message": "string"}
{  "message": "string"}

Delete a sandbox DELETE

Delete a sandbox. Running sandboxes are terminated first. Paused and stopped sandboxes are deleted directly. Requests fail while the sandbox is in a transition state.

Stop a sandbox POST

Stop a running sandbox while preserving its writable disk changes. The sandbox transitions through `stopping` to `stopped`. Unlike pause, stop does not preserve in-memory execution state.