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"}

Start a stopped sandbox POST

Start a sandbox that is currently `stopped`. Leap0 boots a fresh VM from the original template and reapplies the persisted writable disk diff before the sandbox returns to `running`.

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.