Persistent Sandboxes

Long-running development environments with durable storage

Overview

Persistent sandboxes maintain their file system across sessions. Use them for development environments, long-running analysis, or AI agent workspaces that need state.

Create

Persistent sandboxes require a name and a template; resources are optional and use cpu / memory (MB) / disk (GB):

bash

curl -X POST https://api.scalix.world/v1/persistent \
  -H "Authorization: Bearer $SCALIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "dev-workspace",
    "template": "node",
    "resources": { "cpu": 2, "memory": 4096, "disk": 10 }
  }'

Features

Durable storage — files persist across restarts
Package installation — install dependencies that survive reboots
Pause and resume — stop compute while keeping the disk
Snapshots — capture and restore sandbox state

Resource Limits

Resource	Default	Max
Memory	4096 MB	32 GB
vCPUs	2	16
Disk	10 GB	100 GB

Pause and Resume

bash

# Pause (preserves disk)
curl -X POST https://api.scalix.world/v1/persistent/{id}/pause \
  -H "Authorization: Bearer $SCALIX_API_KEY"
 
# Resume
curl -X POST https://api.scalix.world/v1/persistent/{id}/resume \
  -H "Authorization: Bearer $SCALIX_API_KEY"

Snapshots

Capture the sandbox state at a point in time:

bash

curl -X POST https://api.scalix.world/v1/persistent/{id}/snapshot \
  -H "Authorization: Bearer $SCALIX_API_KEY"