Workspaces

A workspace is the top-level organizational unit in XWidget Cloud. It groups projects, manages member access, and tracks usage against plan limits.

List Workspaces

List all workspaces you belong to:

$ xc cloud workspace list

Displays a table with columns: Workspace, Role.

$ xc cloud workspace rename <name> [new-name]

Argument	Required	Description
`<name>`	Yes	Current workspace name
`[new-name]`	No	New name (prompted if not provided)

Workspace names must be 64 characters or less. The CLI prompts for confirmation before renaming.

Example:

$ xc cloud workspace rename "My Workspace" "Appfluent"

Display usage metrics for a workspace:

$ xc cloud usage [options]

Option	Abbr	Description
`--workspace`	`-w`	Workspace to query (prompted if not provided)

Displays a table with columns: Metric, Period Type, Period, Limit, Used.

Byte-based metrics (such as storage_bytes) are displayed in human-readable units. All other metrics are displayed as formatted numbers.

Example:

$ xc cloud usage -w "Appfluent"

When a command requires a workspace and you don't specify one with --workspace / -w: