Skip to main content
CLI workspace context selection scoping commands to the active workspace.
The workspaces commands let you list your workspaces and switch which one the CLI targets. The active workspace is sent with every API request so all other commands automatically operate in the right context. Alias: cnap ws

​
List workspaces

cnap workspaces list

​
Switch workspace

# Interactive picker
cnap workspaces switch

# By ID
cnap workspaces switch <workspace-id>
If no ID is given, an interactive picker lets you choose from your workspaces. The selection is saved to ~/.cnap/config.yaml as active_workspace.

​
API reference

Workspaces API

Endpoints, parameters, response shapes, and try-it playground.

Authentication

Mint API tokens for programmatic access.

Workspaces

Understand workspace roles and member management.

Clusters

Manage clusters in the active workspace.

Products

Browse products in the active workspace.

CLI overview

Authentication, output formats, and configuration.