Skip to main content
Workspaces provide a structured way to organize and manage resources within an IBM Cloud environment. A workspace defines an isolated context where resources such as agents, tools, and toolkits are created and managed. It enables clear separation of resources while it maintains consistent workflows across environments. Each environment includes a global workspace by default. More workspaces can be created to support independent resource management. When you work within a workspace, all operations are scoped to that workspace context. Workspace functions are available through the orchestrate workspaces command group in the CLI. This command group provides capabilities to create, list, remove, activate, deactivate, and export workspaces, and manage workspace membership.
Workspaces are supported only for IBM Cloud environments.

​
Workspace context

A workspace must be activated to be used as the current working context. When activated, all subsequent CLI operations are run within that workspace. It includes creating, importing, updating, and listing resources. If no workspace is explicitly specified in a command, the active workspace is used by default.

​
Workspace management

Workspaces can be created or updated by using a single command. Listing workspaces returns all available workspaces within the tenant and indicates the currently active workspace. Workspaces can also be removed, with options to control how associated resources are handled. Workspaces can be exported into a ZIP file, which includes all resources within the workspace. It allows workspace resources to be packaged and reused.

​
Workspace membership

Workspaces support membership management to control access. Users can be added to a workspace with assigned roles. Supported roles include:
  • Owner – Full management access to the workspace, including managing members and workspace configuration
  • Editor – Access to use and interact with workspace resources Membership operations include adding or updating users, listing current members, and removing users from a workspace. When a workspace is active, membership commands operate on that workspace unless another workspace is specified.

​
Command structure

Workspace functions are organized under the following CLI structure:
  • orchestrate workspaces – Workspace lifecycle management
  • orchestrate workspaces members – Workspace membership management These commands provide a consistent interface for managing workspace configuration and access.