Scheduled Wake-ups

Wake persistent sandboxes on a cron schedule, at a fixed time, or on an event

Overview

Coming soon. Scheduled wake-ups depend on persistent sandboxes, which are not yet generally available. The API surface below is published for preview. Ephemeral sandboxes are available today.

Persistent sandboxes can be paused to save resources and woken automatically. A schedule attaches to an existing persistent sandbox and resumes it on a cron expression, at a fixed time, or when a named event fires. Use this for periodic data processing, report generation, or agents that only need to run at certain times.

Create a Schedule

Attach a schedule to a persistent sandbox. type is one of cron, time, or event:

bash

# Wake every day at 03:00 UTC
curl -X POST https://api.scalix.world/v1/scheduler \
  -H "Authorization: Bearer $SCALIX_API_KEY" \
  -d '{
    "sandboxId": "psbx_abc123",
    "type": "cron",
    "expression": "0 3 * * *"
  }'
 
# Wake once at a fixed time
curl -X POST https://api.scalix.world/v1/scheduler \
  -H "Authorization: Bearer $SCALIX_API_KEY" \
  -d '{
    "sandboxId": "psbx_abc123",
    "type": "time",
    "scheduledTime": "2026-07-01T09:00:00Z"
  }'
 
# Wake when an event fires
curl -X POST https://api.scalix.world/v1/scheduler \
  -H "Authorization: Bearer $SCALIX_API_KEY" \
  -d '{
    "sandboxId": "psbx_abc123",
    "type": "event",
    "eventType": "deploy.completed"
  }'

Manage Schedules

bash

# List your schedules
curl https://api.scalix.world/v1/scheduler \
  -H "Authorization: Bearer $SCALIX_API_KEY"
 
# Get the schedule for a sandbox
curl https://api.scalix.world/v1/scheduler/{sandboxId} \
  -H "Authorization: Bearer $SCALIX_API_KEY"
 
# Update (change expression, or disable without deleting)
curl -X PATCH https://api.scalix.world/v1/scheduler/{sandboxId} \
  -H "Authorization: Bearer $SCALIX_API_KEY" \
  -d '{"expression": "0 6 * * *", "enabled": true}'
 
# Skip the next run (disables the schedule until you re-enable it)
curl -X POST https://api.scalix.world/v1/scheduler/{sandboxId}/cancel \
  -H "Authorization: Bearer $SCALIX_API_KEY"
 
# Delete
curl -X DELETE https://api.scalix.world/v1/scheduler/{sandboxId} \
  -H "Authorization: Bearer $SCALIX_API_KEY"

Schedules can also be edited and skipped from the console — each scheduled task card on the Sandboxes page has Edit and Skip next run actions.

Upcoming Wake-ups

bash

curl https://api.scalix.world/v1/scheduler/upcoming \
  -H "Authorization: Bearer $SCALIX_API_KEY"

Fire an Event

Wake every sandbox subscribed to an event type:

bash

curl -X POST https://api.scalix.world/v1/scheduler/events \
  -H "Authorization: Bearer $SCALIX_API_KEY" \
  -d '{"eventType": "deploy.completed", "data": {"service": "api-server"}}'