Run a command in a sandbox

Create a sandbox session, run a short command, and delete the session 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 session

Create a session with POST /sandbox-sessions:

create-session.sh

curl -X POST https://api.veryfront.com/sandbox-sessions \
  -H "Authorization: Bearer $VERYFRONT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"project_reference":"support-assistant","ttl_mode":"duration","ttl_hours":1}'

Set SESSION_ID to the response’s id value.

2. Check readiness

Call GET /sandbox-sessions/{session_id}/readyz before sending a command:

check-readiness.sh

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

Continue after a successful readiness response. If the session is still provisioning, wait briefly and check again. A 404 means the selected session was not found; a 502 reports a data-plane failure.

3. Run a command

Run a command with POST /sandbox-sessions/{session_id}/commands/run:

run-command.sh

curl -X POST "https://api.veryfront.com/sandbox-sessions/$SESSION_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 session lifetimes.

Verify the result

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

4. Delete the session

Call DELETE /sandbox-sessions/{session_id} after saving any files you need:

delete-session.sh

curl -X DELETE "https://api.veryfront.com/sandbox-sessions/$SESSION_ID" \
  -H "Authorization: Bearer $VERYFRONT_API_KEY"

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

API references

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

Get started

APIs

REST API

GraphQL API

MCP API

Run a command in a sandbox

1. Create a sandbox session

2. Check readiness

3. Run a command

Verify the result

4. Delete the session

API references

​1. Create a sandbox session

​2. Check readiness

​3. Run a command

​Verify the result

​4. Delete the session

​API references

1. Create a sandbox session

2. Check readiness

3. Run a command

Verify the result

4. Delete the session

API references