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 sandboxes are deleted directly. Requests fail while the sandbox is in a transition state.

Add an object storage mount POST

Attach a new object storage mount to a running sandbox. Credentials remain on the runner and are not exposed inside the sandbox.