Run a command in a sandbox

Create a sandbox, run a short command, and delete the sandbox when the work is finished. Set an API credential. Include project_reference to identify the project to bill; an environment can also supply project context and initial variables.

1. Create a sandbox

Create a sandbox with POST /sandboxes:

create-sandbox.sh

curl -X POST https://api.veryfront.com/sandboxes \
  -H "Authorization: Bearer $VERYFRONT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"access_scope":"project","project_reference":"<PROJECT_ID>","ttl_mode":"duration","ttl_hours":1}'

Set SANDBOX_ID to the response’s id value.

2. Check readiness

Call GET /sandboxes/{sandbox_id}/readyz before sending a command:

check-readiness.sh

export SANDBOX_ID="<SANDBOX_ID>"
curl --include "https://api.veryfront.com/sandboxes/$SANDBOX_ID/readyz" \
  -H "Authorization: Bearer $VERYFRONT_API_KEY"

Continue when the readiness response has ok: true. If the sandbox is still provisioning, wait briefly and check again. A 404 means the selected sandbox was not found; a 503 reports runtime unavailability.

3. Run a command

Run a command with POST /sandboxes/{sandbox_id}/commands/run:

run-command.sh

curl -X POST "https://api.veryfront.com/sandboxes/$SANDBOX_ID/commands/run" \
  -H "Authorization: Bearer $VERYFRONT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"command":"pwd"}'

For longer work, use a background command and retrieve its status and output separately. The Sandbox API describes command and sandbox lifetimes.

Verify the result

Confirm that the command result contains the working directory printed by pwd. A created sandbox alone does not confirm that a command succeeded.

4. Delete the sandbox

Call DELETE /sandboxes/{sandbox_id} after saving any files you need:

delete-sandbox.sh

curl -X DELETE "https://api.veryfront.com/sandboxes/$SANDBOX_ID" \
  -H "Authorization: Bearer $VERYFRONT_API_KEY"

A successful deletion ends the sandbox. Its lifetime policy also limits availability if you leave it running.

API references

Interface	Operations
REST	Create a sandbox · Run a command · Delete a sandbox
GraphQL	Create a sandbox · Run a command
MCP	Create a sandbox · Run a command

Get started

APIs

REST API

GraphQL API

MCP API

Run a command in a sandbox

1. Create a sandbox

2. Check readiness

3. Run a command

Verify the result

4. Delete the sandbox

API references

​1. Create a sandbox

​2. Check readiness

​3. Run a command

​Verify the result

​4. Delete the sandbox

​API references

1. Create a sandbox

2. Check readiness

3. Run a command

Verify the result

4. Delete the sandbox

API references