Project Commands

Reference for scalebox-cli project commands.

All commands on this page also accept --compact for one-line JSON output.

`project list`

List projects. Root users can filter by owner with --owner-user-id USER_ID.

scalebox-cli project list
scalebox-cli project list --owner-user-id usr_123

List-style output uses the canonical nested pagination shape:

{
  "projects": [],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 0,
    "total_pages": 0,
    "offset": 0
  }
}

Create a project with --name. Optional flags: --description, --default.

scalebox-cli project create --name frontend --description "Frontend work" --default

Show one project.

scalebox-cli project get prj_123

Update one or more fields with --name, --description, or --default. The CLI returns an error if none of those flags are set.

scalebox-cli project update prj_123 --name platform --description "Platform team"

Delete an empty project.

scalebox-cli project delete prj_123

List sandboxes in a project. Supported flags: --status, --skip, --limit.

scalebox-cli project sandboxes prj_123 --status running --skip 0 --limit 50

The JSON envelope is:

{
  "sandboxes": [],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 0,
    "total_pages": 0,
    "offset": 0
  }
}

Attach a running sandbox to a project.

scalebox-cli project add-sandbox prj_123 sbx_123

Move a running sandbox from a project back to your default project.

scalebox-cli project evict-sandbox prj_123 sbx_123