> ## 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.

# base44 workspace list

> List the workspaces (organizations) you belong to.

<Warning>
  This page is part of an AI coding agent skill and is written for agents, not humans. For the human-readable Base44 docs, see the [developer documentation](/developers).
</Warning>

# base44 workspace list

List the workspaces (organizations) you belong to.

Does not require a linked project — works from any directory.

## Syntax

```bash theme={null}
npx base44 workspace list [options]
```

## Options

| Option          | Description                                                                         | Required |
| --------------- | ----------------------------------------------------------------------------------- | -------- |
| `--role <role>` | Only show workspaces where your role matches (`owner`, `admin`, `editor`, `viewer`) | No       |

## Examples

```bash theme={null}
# List all workspaces you belong to
npx base44 workspace list

# Only workspaces where you're an owner
npx base44 workspace list --role owner

# Machine-readable output
npx base44 workspace list --json
```

## Output

Human mode prints each workspace's name, role/personal tag, and ID. With `--json`, stdout is an array of workspace objects: `id`, `name`, `userRole`, `subscriptionTier`, `isEnterprise`.

## Notes

* Use this to find a workspace ID for `base44 create --workspace <id>`, `base44 link --workspace <id>`, or `base44 workspace move <id>`.