Agentuity Documentation

Use these commands to test code execution, debug running sandboxes, and create snapshots without writing application code.

Cloud Prefix Required

All sandbox commands require the cloud prefix. For example: agentuity cloud sandbox run ...

Quick Reference

Command	Description
`sandbox run -- <cmd>`	One-shot execution
`sandbox create`	Create interactive sandbox
`sandbox list`	List sandboxes
`sandbox get <id>`	Get sandbox details
`sandbox delete <id>`	Destroy sandbox
`sandbox exec <id> -- <cmd>`	Execute in existing sandbox
`sandbox pause <id>`	Pause a running sandbox
`sandbox resume <id>`	Resume a paused sandbox
`sandbox fs cp`	Copy files to/from sandbox
`sandbox fs ls <id>`	List files in sandbox
`sandbox fs mkdir <id> <path>`	Create directory
`sandbox fs rmdir <id> <path>`	Remove directory
`sandbox fs rm <id> <path>`	Remove file
`sandbox fs download <id> <output>`	Download as archive
`sandbox fs upload <id> <archive>`	Upload and extract archive
`sandbox snapshot`	Manage snapshots
`sandbox snapshot build <dir>`	Build snapshot from declarative file
`sandbox snapshot generate`	Generate template snapshot build file
`sandbox checkpoint`	Manage sandbox checkpoints
`sandbox execution`	View execution history
`sandbox events <id>`	List sandbox lifecycle events
`sandbox runtime list`	List available runtimes
`sandbox env <id>`	Manage environment variables
`sandbox job`	Manage background jobs
`sandbox stats`	View sandbox statistics

Aliases:

sb → sandbox (e.g., agentuity cloud sb list)
sandbox rm → sandbox delete (e.g., agentuity cloud sandbox rm sbx_abc123)
sandbox delete also accepts: rm, del, remove, destroy, terminate
sandbox fs also accepts: files, file
All get commands also accept: show, info
All list commands also accept: ls
All create commands also accept: new

SSH Access

You can SSH directly into a running sandbox for interactive debugging. See Debugging Deployments for full SSH documentation, including setup and key management.

# SSH into a sandbox
agentuity cloud ssh sbx_abc123xyz
 
# Run a command and exit
agentuity cloud ssh sbx_abc123xyz 'ls -la /workspace'
 
# Show SSH command without executing
agentuity cloud ssh sbx_abc123xyz --show

SSH Key Required

Before you can SSH into a sandbox, you must add your SSH public key to your Agentuity account. See SSH Key Management for setup instructions.

One-shot Execution

Run a single command in a new sandbox that's automatically destroyed afterward.

agentuity cloud sandbox run [options] -- <command>

Options

Option	Description
`--memory <size>`	Memory limit (e.g., `512Mi`, `1Gi`)
`--cpu <millicores>`	CPU limit (e.g., `500m`, `1000m`)
`--disk <size>`	Disk limit
`--network`	Enable outbound network access
`--timeout <duration>`	Execution timeout (e.g., `30s`, `5m`)
`--snapshot <id-or-tag>`	Create from snapshot
`--runtime <runtime>`	Runtime name (e.g., `bun:1`, `python:3.14`)
`--runtime-id <id>`	Runtime ID (e.g., `srt_xxx`)
`--dependency <package>`	Apt packages to install (repeatable)
`--env <KEY=VALUE>`	Environment variables (repeatable)
`--file <sandbox-path:local-path>`	Files to create (repeatable)
`--scope <scope>`	Permission scope for service access (repeatable)
`--project-id <id>`	Associate with project
`--org-id <id>`	Use a specific organization
`--quiet`	Suppress stdout/stderr stream output
`--json`	JSON output
`--timestamps`	Include timestamps in stream output

Examples

# Simple command
agentuity cloud sandbox run -- echo "Hello, World!"
 
# Python with network access
agentuity cloud sandbox run --network -- python3 -c "import urllib.request; print(urllib.request.urlopen('https://httpbin.org/ip').read())"
 
# From a snapshot with resource limits
agentuity cloud sandbox run --snapshot node-typescript --memory 1Gi -- npm run build
 
# With timeout
agentuity cloud sandbox run --timeout 10s -- sh -c 'sleep 5 && echo "Done"'

Interactive Sandbox

Create a persistent sandbox for multiple commands.

Create

agentuity cloud sandbox create [options]

Option	Description
`--memory <size>`	Memory limit
`--cpu <millicores>`	CPU limit
`--disk <size>`	Disk limit
`--network`	Enable outbound network
`--snapshot <id-or-tag>`	Create from snapshot
`--idle-timeout <duration>`	Auto-destroy after idle (e.g., `1h`)
`--runtime <runtime>`	Runtime name (e.g., `bun:1`, `python:3.14`)
`--runtime-id <id>`	Runtime ID (e.g., `srt_xxx`)
`--name <name>`	Sandbox name
`--description <text>`	Sandbox description
`--port <port>`	Port to expose (1024-65535)
`--dependency <package>`	Apt packages to install (repeatable)
`--env <KEY=VALUE>`	Environment variables (repeatable)
`--file <sandbox-path:local-path>`	Files to create (repeatable)
`--metadata <json>`	User-defined metadata (JSON)
`--scope <scope>`	Permission scope for service access (repeatable)
`--project-id <id>`	Associate with project
`--org-id <id>`	Use a specific organization

# Create with defaults
agentuity cloud sandbox create
 
# Create with resources and network
agentuity cloud sandbox create --memory 1Gi --cpu 1000m --network
 
# Create from snapshot
agentuity cloud sandbox create --snapshot python-ml
 
# Create with port exposed to internet
agentuity cloud sandbox create --port 3000 --name my-server
 
# Create associated with a project
agentuity cloud sandbox create --project-id proj_abc123

Execute Command

agentuity cloud sandbox exec <sandbox-id> [options] -- <command>

Option	Description
`--timeout <duration>`	Execution timeout (e.g., `5m`, `1h`)
`--timestamps`	Include timestamps in stream output
`--quiet`	Suppress stdout/stderr stream output

# Run commands in sequence
agentuity cloud sandbox exec sbx_abc123 -- npm init -y
agentuity cloud sandbox exec sbx_abc123 -- npm install zod
agentuity cloud sandbox exec sbx_abc123 -- npm run build

List Sandboxes

agentuity cloud sandbox list [options]

Option	Description
`--status <status>`	Filter by status (`creating`, `idle`, `running`, `paused`, `stopping`, `suspended`, `terminated`, `failed`)
`--name <name>`	Filter by sandbox name
`--mode <mode>`	Filter by mode (`oneshot`, `interactive`)
`--project-id <id>`	Filter by project
`--org-id <id>`	Filter by organization
`--all`	List all sandboxes (bypass project filter)
`--limit <n>`	Max results (default: 50, max: 100)
`--offset <n>`	Pagination offset
`--sort <field>`	Sort by `name`, `created`, `updated`, `status`, `mode`, or `execution_count` (default: `created`)
`--direction <dir>`	Sort direction: `asc` or `desc` (default: `desc`)
`--json`	JSON output

agentuity cloud sandbox list
agentuity cloud sandbox list --status idle
agentuity cloud sandbox list --name my-sandbox
agentuity cloud sandbox list --project-id proj_abc123
agentuity cloud sandbox list --sort=created --direction=desc
agentuity cloud sandbox list --all  # Show all sandboxes
agentuity cloud sandbox list --json

Get Sandbox Details

agentuity cloud sandbox get <sandbox-id>

Shows sandbox status, creation time, resource usage, and execution count.

Delete Sandbox

agentuity cloud sandbox delete <sandbox-id> [--confirm]

Aliases: rm, del, remove, destroy, terminate

agentuity cloud sandbox delete sbx_abc123
agentuity cloud sandbox delete sbx_abc123 --confirm  # Skip prompt
 
# Using alias
agentuity cloud sandbox rm sbx_abc123

sandbox rm vs sandbox fs rm

sandbox rm <sandbox-id> deletes the sandbox itself (alias for sandbox delete). To remove a file inside a sandbox, use sandbox fs rm <sandbox-id> <path>.

Pause and Resume

Pause a running sandbox, then resume it later:

agentuity cloud sandbox pause sbx_abc123
agentuity cloud sandbox resume sbx_abc123

Aliases: pause also accepts hibernate; resume also accepts wake.

Port Mapping

Expose a port from a sandbox to the public internet. This allows you to run web servers, APIs, or any network service inside a sandbox and access it from external clients.

Create with Port

agentuity cloud sandbox create --port 3000 --name my-server

Port constraints:

Must be between 1024 and 65535 (no privileged ports)
Passing --port enables sandbox networking for the exposed port
Each sandbox can expose one port

Access the Public URL

When you create a sandbox with --port, the public URL is returned directly in the create response:

agentuity cloud sandbox create --port 3000 --name my-server --json
# { "sandboxId": "sbx_abc123", "status": "creating", "url": "https://my-server-abc123.agentuity.cloud", ... }

In human-readable output, the URL is displayed after creation:

✓ created sandbox sbx_abc123 in 1200ms
ℹ url: https://my-server-abc123.agentuity.cloud

You can also retrieve the URL later with get:

agentuity cloud sandbox get sbx_abc123

Example: Run a Web Server

# Create sandbox with port 3000. The URL is returned immediately.
agentuity cloud sandbox create --port 3000 --name my-api
# ✓ created sandbox sbx_abc123 in 1200ms
# ℹ url: https://my-api-abc123.agentuity.cloud
 
# Upload server code
agentuity cloud sandbox fs cp ./server.js sbx_abc123:/home/agentuity/
 
# Start the server
agentuity cloud sandbox exec sbx_abc123 -- bun run /home/agentuity/server.js
 
# Test from anywhere using the URL from create
curl https://my-api-abc123.agentuity.cloud/api/health

File Operations

File operations are grouped under the sandbox fs subcommand.

Copy Files

Copy individual files or directories to and from sandboxes. Parent directories are automatically created if they don't exist, similar to mkdir -p.

agentuity cloud sandbox fs cp <source> <destination> [options]

Option	Description
`-r, --recursive`	Copy directories recursively
`--strict`	Fail if target parent directory doesn't exist (disables auto-creation)
`--timeout <duration>`	Operation timeout (e.g., `5m`, `1h`)
`--json`	JSON output

# Upload a file
agentuity cloud sandbox fs cp ./local-file.txt sbx_abc123:/workspace/file.txt
 
# Download a file
agentuity cloud sandbox fs cp sbx_abc123:/workspace/output.json ./output.json
 
# Upload a directory recursively
agentuity cloud sandbox fs cp -r ./src sbx_abc123:/workspace/src
 
# Upload to a path with non-existent parent directories (auto-created)
agentuity cloud sandbox fs cp ./config.json sbx_abc123:/home/agentuity/app/config/settings.json
 
# Strict mode — fail if target directory doesn't exist
agentuity cloud sandbox fs cp --strict ./file.txt sbx_abc123:/home/agentuity/must-exist/file.txt

Automatic Parent Directory Creation

Unlike POSIX cp, sandbox fs cp automatically creates parent directories if they don't exist. For example, copying to sbx_id:/home/agentuity/new/nested/path/file.txt will create /home/agentuity/new and /home/agentuity/new/nested/path automatically. Use --json to see which directories were created in the directoriesCreated field. Use --strict to disable this behavior and fail if the target directory doesn't exist.

JSON Output

When using --json, the response includes details about auto-created directories:

agentuity cloud sandbox fs cp ./file.txt sbx_abc123:/home/agentuity/new/path/file.txt --json

{
  "source": "./file.txt",
  "destination": "sbx_abc123:/home/agentuity/new/path/file.txt",
  "bytesTransferred": 1024,
  "filesTransferred": 1,
  "directoriesCreated": [
    "/home/agentuity/new",
    "/home/agentuity/new/path"
  ]
}

List Files

List files and directories in a sandbox.

agentuity cloud sandbox fs ls <sandbox-id> [path] [options]

Option	Description
`-l, --long`	Show permissions and timestamps
`--json`	JSON output

# List root directory
agentuity cloud sandbox fs ls sbx_abc123
 
# List specific directory
agentuity cloud sandbox fs ls sbx_abc123 /workspace/src
 
# Long format with details
agentuity cloud sandbox fs ls sbx_abc123 -l

Create Directory

agentuity cloud sandbox fs mkdir <sandbox-id> <path> [options]

Option	Description
`-p, --parents`	Create parent directories as needed

# Create a directory
agentuity cloud sandbox fs mkdir sbx_abc123 /workspace/output
 
# Create nested directories
agentuity cloud sandbox fs mkdir sbx_abc123 /workspace/data/processed -p

Remove Files and Directories

Use sandbox fs rm to remove individual files and sandbox fs rmdir to remove directories. The rmdir command requires the -r flag to remove directories that contain files.

# Remove a file
agentuity cloud sandbox fs rm <sandbox-id> <path>
 
# Remove a directory
agentuity cloud sandbox fs rmdir <sandbox-id> <path> [options]

Option	Description
`-r, --recursive`	Remove directory and all contents

# Remove a file
agentuity cloud sandbox fs rm sbx_abc123 /workspace/temp.txt
 
# Remove empty directory
agentuity cloud sandbox fs rmdir sbx_abc123 /workspace/old
 
# Remove directory with contents
agentuity cloud sandbox fs rmdir sbx_abc123 /workspace/cache -r

Download Archive

Download sandbox files as a compressed archive.

agentuity cloud sandbox fs download <sandbox-id> <output-file> [options]

Option	Description
`--path <path>`	Download specific directory (defaults to root)
`--format <format>`	Archive format: `tar.gz` (default) or `zip`

Alias: dl

# Download entire sandbox
agentuity cloud sandbox fs download sbx_abc123 ./backup.tar.gz
 
# Download as zip
agentuity cloud sandbox fs download sbx_abc123 ./backup.zip --format zip
 
# Download specific directory
agentuity cloud sandbox fs download sbx_abc123 ./src.tar.gz --path /workspace/src

Upload Archive

Upload and extract an archive into a sandbox.

agentuity cloud sandbox fs upload <sandbox-id> <archive-file> [options]

Option	Description
`--path <path>`	Destination path (defaults to root)
`--format <format>`	Archive format (auto-detected if not specified)

Alias: ul

# Upload and extract to root
agentuity cloud sandbox fs upload sbx_abc123 ./project.tar.gz
 
# Upload to specific directory
agentuity cloud sandbox fs upload sbx_abc123 ./deps.zip --path /workspace/node_modules

Snapshot Commands

Manage sandbox snapshots for creating pre-configured environments.

Create Snapshot

agentuity cloud sandbox snapshot create <sandbox-id> [options]

Option	Description
`--name <name>`	Display name for the snapshot
`--description <text>`	Snapshot description
`--tag <tag>`	Snapshot tag (defaults to `latest`)
`--public`	Make the snapshot publicly accessible
`--org-id <id>`	Use a specific organization

# Create snapshot
agentuity cloud sandbox snapshot create sbx_abc123
 
# Create with tag
agentuity cloud sandbox snapshot create sbx_abc123 --tag python-ml-v2
 
# Create public snapshot
agentuity cloud sandbox snapshot create sbx_abc123 --public

List Snapshots

agentuity cloud sandbox snapshot list [options]

Option	Description
`--sandbox <id>`	Filter by source sandbox
`--limit <n>`	Max results
`--offset <n>`	Pagination offset
`--sort <field>`	Sort by `name`, `created`, `size`, or `files` (default: `created`)
`--direction <dir>`	Sort direction: `asc` or `desc` (default: `desc`)
`--json`	JSON output

agentuity cloud sandbox snapshot list
agentuity cloud sandbox snapshot list --sandbox sbx_abc123
agentuity cloud sandbox snapshot list --sort=size --direction=desc

Get Snapshot Details

agentuity cloud sandbox snapshot get <snapshot-id>

Shows snapshot size, file count, tag, and sandboxes created from it.

Tag Snapshot

agentuity cloud sandbox snapshot tag <snapshot-id> <tag-name>
agentuity cloud sandbox snapshot tag <snapshot-id> --clear

# Set tag
agentuity cloud sandbox snapshot tag snp_xyz789 latest
 
# Update tag
agentuity cloud sandbox snapshot tag snp_xyz789 v2.0
 
# Remove tag
agentuity cloud sandbox snapshot tag snp_xyz789 --clear

Delete Snapshot

agentuity cloud sandbox snapshot delete <snapshot-id> [--confirm]

agentuity cloud sandbox snapshot delete snp_xyz789
agentuity cloud sandbox snapshot delete snp_xyz789 --confirm

Build Snapshot from File

Build a snapshot from a declarative YAML or JSON file. This provides reproducible, version-controlled snapshot definitions.

agentuity cloud sandbox snapshot build <directory> [options]

Option	Description
`--file <file>`	Path to build file (defaults to `agentuity-snapshot.[json
`--tag <tag>`	Snapshot tag (defaults to `latest`)
`--name <name>`	Snapshot name (overrides build file)
`--description <text>`	Snapshot description (overrides build file)
`--env <KEY=VALUE>`	Environment variable substitution (repeatable)
`--metadata <KEY=VALUE>`	Metadata key-value pairs (repeatable)
`--force`	Force rebuild even if content unchanged
`--public`	Make the snapshot public
`--confirm`	Confirm public snapshot publishing
`--org-id <id>`	Use a specific organization

# Build from current directory
agentuity cloud sandbox snapshot build .
 
# Build with custom file and tag
agentuity cloud sandbox snapshot build ./project --file custom-build.yaml --tag production
 
# Build with environment substitution
agentuity cloud sandbox snapshot build . --env API_KEY=secret --env VERSION=1.0.0
 
# Force rebuild
agentuity cloud sandbox snapshot build . --force

Build File Format

Create an agentuity-snapshot.yaml file. Use glob patterns to include files and prefix with ! to exclude:

# Required: Schema version
version: 1
 
# Required: Runtime environment
runtime: bun:1
 
# Optional: Snapshot name
name: my-snapshot
 
# Optional: Description
description: My sandbox snapshot
 
# Optional: Apt packages to install
dependencies:
  - curl
  - ffmpeg
  - imagemagick
 
# Optional: Files to include (supports globs and exclusions)
# Prefix with ! to exclude files
files:
  - "*.js"
  - src/**
  - config/*.json
  - "!**/*.test.js"     # Exclude test files
  - "!node_modules/**"  # Exclude node_modules
 
# Optional: Environment variables
env:
  NODE_ENV: production
  API_URL: https://api.example.com
  SECRET_KEY: ${SECRET_KEY}  # Substituted via --env flag
 
# Optional: Metadata
metadata:
  version: ${VERSION}
  author: team-name

Generate Build Template

Generate a template snapshot build file to get started:

agentuity cloud sandbox snapshot generate [options]

Option	Description
`--format <format>`	Output format: `yaml` (default) or `json`

# Generate YAML template (default)
agentuity cloud sandbox snapshot generate > agentuity-snapshot.yaml
 
# Generate JSON template
agentuity cloud sandbox snapshot generate --format json > agentuity-snapshot.json

Getting Started

The generated template includes helpful comments explaining each field. See Creating and Using Snapshots for workflows and use cases.

Sandbox Checkpoints

Use checkpoints to save and restore a sandbox filesystem without creating a reusable snapshot.

# Create a checkpoint
agentuity cloud sandbox checkpoint create sbx_abc123 my-checkpoint
 
# List checkpoints
agentuity cloud sandbox checkpoint list sbx_abc123
 
# Restore by checkpoint ID or name
agentuity cloud sandbox checkpoint restore sbx_abc123 ckpt_def456
agentuity cloud sandbox checkpoint restore sbx_abc123 my-checkpoint
 
# Delete a checkpoint
agentuity cloud sandbox checkpoint delete sbx_abc123 ckpt_def456 --confirm

Alias: ckpt (e.g., agentuity cloud sandbox ckpt list sbx_abc123)

Execution History

View past command executions within a sandbox.

List Executions

agentuity cloud sandbox execution list <sandbox-id> [--limit <n>]

agentuity cloud sandbox execution list sbx_abc123
agentuity cloud sandbox execution list sbx_abc123 --limit 5

Get Execution Details

agentuity cloud sandbox execution get <execution-id>

Shows command, exit code, duration, and stream URLs for stdout/stderr.

Events

View lifecycle events for a sandbox. Events are displayed in chronological order (oldest first) by default.

List Events

agentuity cloud sandbox events <sandbox-id> [options]

Option	Description
`--limit <n>`	Maximum number of results (default: 50, max: 100)
`--reverse`	Show newest events first
`--json`	Output as JSON

# List events oldest first (default)
agentuity cloud sandbox events sbx_abc123
 
# List events newest first
agentuity cloud sandbox events sbx_abc123 --reverse
 
# Limit to last 10 events
agentuity cloud sandbox events sbx_abc123 --limit 10

Events include lifecycle state changes such as create, destroy, pause, resume, lifecycle:started, lifecycle:completed, lifecycle:failed, and lifecycle:terminated.

Statistics

View sandbox usage statistics for an organization:

agentuity cloud sandbox stats
agentuity cloud sandbox stats --start 2026-04-01T00:00:00Z --end 2026-04-22T00:00:00Z

Common Workflows

Set Up a Development Environment

# Create sandbox with network access
agentuity cloud sandbox create --memory 2Gi --network
# sbx_abc123
 
# Install dependencies
agentuity cloud sandbox exec sbx_abc123 -- apt-get update
agentuity cloud sandbox exec sbx_abc123 -- apt-get install -y python3 python3-pip
agentuity cloud sandbox exec sbx_abc123 -- pip install numpy pandas scikit-learn
 
# Create snapshot for reuse
agentuity cloud sandbox snapshot create sbx_abc123 --tag python-ml
 
# Clean up original sandbox
agentuity cloud sandbox delete sbx_abc123

Run Code from Snapshot

# Create sandbox from snapshot (fast - deps already installed)
agentuity cloud sandbox create --snapshot python-ml
# sbx_def456
 
# Upload and run code
agentuity cloud sandbox fs cp ./analysis.py sbx_def456:/workspace/
agentuity cloud sandbox exec sbx_def456 -- python3 /workspace/analysis.py
 
# Download results
agentuity cloud sandbox fs cp sbx_def456:/workspace/output.csv ./results.csv
 
# Clean up
agentuity cloud sandbox delete sbx_def456

Quick One-shot Testing

# Test Python code
agentuity cloud sandbox run -- python3 -c "print(sum(range(100)))"
 
# Test with dependencies from snapshot
agentuity cloud sandbox run --snapshot python-ml -- python3 -c "import numpy; print(numpy.array([1,2,3]).mean())"
 
# Test with network
agentuity cloud sandbox run --network -- curl -s https://api.github.com/zen

JSON Output

All commands support --json for machine-readable output:

agentuity cloud sandbox list --json
agentuity cloud sandbox get sbx_abc123 --json
agentuity cloud sandbox snapshot list --json

Runtime Commands

List available sandbox runtimes.

List Runtimes

agentuity cloud sandbox runtime list [options]

Option	Description
`--limit <n>`	Max results (default: 50, max: 100)
`--offset <n>`	Pagination offset
`--sort <field>`	Sort by `name` or `created` (default: `created`)
`--direction <dir>`	Sort direction: `asc` or `desc` (default: `desc`)
`--json`	JSON output

# List available runtimes
agentuity cloud sandbox runtime list
 
# Sort alphabetically
agentuity cloud sandbox runtime list --sort=name --direction=asc
 
# With pagination
agentuity cloud sandbox runtime list --limit 10 --offset 20

Alias: rt (e.g., agentuity cloud sandbox rt list)

Environment Variables

Manage environment variables on a running sandbox.

agentuity cloud sandbox env <sandbox-id> [KEY=VALUE...] [options]

Option	Description
`--delete <key>`	Delete variable (repeatable, alias: `-d`)
`--json`	JSON output

# Set an environment variable
agentuity cloud sandbox env sbx_abc123 MY_VAR=value
 
# Set multiple variables
agentuity cloud sandbox env sbx_abc123 VAR1=value1 VAR2=value2
 
# Delete a variable
agentuity cloud sandbox env sbx_abc123 --delete MY_VAR
 
# Delete multiple variables
agentuity cloud sandbox env sbx_abc123 -d VAR1 -d VAR2

Background Jobs

Run long-running commands in a sandbox without blocking. Jobs execute in parallel and continue even after the command that created them returns.

Create Job

agentuity cloud sandbox job create <sandbox-id> -- <command>

# Create a background job
agentuity cloud sandbox job create sbx_abc123 -- bun run build
 
# Run npm install in background
agentuity cloud sandbox job create sbx_abc123 -- npm install

List Jobs

agentuity cloud sandbox job list <sandbox-id> [--limit <n>]

agentuity cloud sandbox job list sbx_abc123
agentuity cloud sandbox job list sbx_abc123 --limit 10

Get Job Status

agentuity cloud sandbox job get <sandbox-id> <job-id>

Shows job status, exit code, start/completion times, and stream URLs for stdout/stderr.

Stop Job

agentuity cloud sandbox job destroy <sandbox-id> <job-id> [--force]

Option	Description
`--force`	Force kill with SIGKILL instead of SIGTERM

# Graceful stop
agentuity cloud sandbox job destroy sbx_abc123 job_xyz789
 
# Force kill
agentuity cloud sandbox job destroy sbx_abc123 job_xyz789 --force

Job Statuses

Status	Description
`pending`	Job created but not yet started
`running`	Job is actively executing
`completed`	Job finished successfully (exit code 0)
`failed`	Job failed (non-zero exit code)
`cancelled`	Job was terminated by user

Use Cases

Build processes: Run builds in background while continuing other work
Long-running tests: Execute test suites without blocking
Data processing: Process large datasets asynchronously
Service daemons: Run background services within a sandbox

Job Output

Job stdout and stderr are captured to streams. Use the stream URLs from job get to retrieve output via the Pulse API.

Next Steps

Sandbox Overview: Understand sandbox concepts, security defaults, and when to use each execution mode
SDK Usage: Use sandboxes programmatically in agents and routes
Snapshots: Pre-configure environments for faster cold starts