Skip to main content
Use nullspace sandbox list to find running, paused, and historical sandboxes. List responses support state, template, metadata, pagination, and field selection.

​
Basic List

nullspace sandbox list
nullspace sandbox list --json
Use JSON output when another script or agent will parse the response.

​
Filter By State

nullspace sandbox list --state running
nullspace sandbox list --state paused
nullspace sandbox list --state destroyed
The public API supports creating, running, paused, destroyed, and error states.

​
Filter By Template Or Metadata

nullspace sandbox list --template base
nullspace sandbox list --metadata team=eval
nullspace sandbox list --metadata-json '{"team":"eval","run":"smoke"}'
Metadata filters match key/value pairs attached at sandbox creation time.

​
Paginate

nullspace sandbox list --limit 20 --json
nullspace sandbox list --limit 20 --next-token nt_...
Use the next_token returned by a JSON response to fetch the next page.

​
Inspect One Sandbox

nullspace sandbox get sb_123
nullspace sandbox get sb_123 --json
nullspace sandbox metrics sb_123 --json
get returns the current sandbox record. metrics returns usage and runtime metrics when the host has reported them.

​
Common Follow-Ups

nullspace sandbox exec sb_123 --shell "pwd && ls -la"
nullspace sandbox url sb_123 8080
nullspace sandbox pause sb_123
nullspace sandbox kill sb_123
For SDK examples, see Create, Connect, And List Sandboxes.