> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# workspace list

> List the workspaces you belong to

List the workspaces your account belongs to, along with your role in each. Use this to find workspace IDs for commands and flags that require one.

## Usage

```bash theme={null}
base44 workspace list
```

## Flags

| Flag            | Description                                                                                               |
| --------------- | --------------------------------------------------------------------------------------------------------- |
| `--role <role>` | Filter to workspaces where your role matches. One of `owner`, `admin`, `editor`, `viewer`                 |
| `--json`        | Output the list as JSON. See [JSON output](/developers/references/cli/commands/introduction#json-output). |

## See also

* [`workspace get`](/developers/references/cli/commands/workspace-get): Show a single workspace by ID
* [`create`](/developers/references/cli/commands/create): Create a new app in a workspace
* [`workspace move`](/developers/references/cli/commands/workspace-move): Move an app to another workspace