Leap0

Add an object storage mount

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

POST
/v1/sandbox/{sandboxID}/mounts

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

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.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

type*string

Mount implementation type.

Value in"object-storage"
bucket*string

Bucket name in the S3-compatible object storage provider.

mount_path*string

Absolute sandbox path where the bucket contents will appear.

endpoint*string

Full S3-compatible endpoint URL.

Formaturi
prefix?string

Optional key prefix within the bucket. Must end with a trailing slash when provided.

read_only?boolean

Whether the mount is read-only. Object storage mounts are currently read-only.

Defaulttrue
access_key_id?string

Access key id for the S3 bucket. Omit for public buckets.

secret_access_key?string

Secret access key for the S3 bucket. Omit for public buckets.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.leap0.dev/v1/sandbox/string/mounts" \  -H "Content-Type: application/json" \  -d '{    "type": "object-storage",    "bucket": "project-assets",    "mount_path": "/data/assets",    "endpoint": "https://storage.example.com"  }'
{  "id": "mnt-abc123",  "type": "object-storage",  "bucket": "string",  "mount_path": "string",  "prefix": "string",  "read_only": true}
{  "message": "string",  "errors": [    {      "field": "string",      "error": "string"    }  ]}
{  "message": "string"}
{  "message": "string"}
{  "message": "string"}

Pause a sandbox POST

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.

Update an object storage mount PATCH

Update an existing object storage mount on a running sandbox. Changing `bucket`, `mount_path`, or `read_only` causes the mount to be remounted. Setting `prefix`, `access_key_id`, or `secret_access_key` to an empty string clears that value.