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

# Workspace management

> Create and manage workspaces, members, and access tokens

A workspace in [BRICKS Controller](/controller) is the top-level container for your devices, applications, modules, and team members.

## Creating a workspace

1. Log in to [BRICKS Controller](https://control.bricks.tools)
2. Click **Create Workspace**
3. Enter a workspace name
4. Choose a subscription plan

## Members and roles

Manage who has access to your workspace and what they can do:

1. Go to **Workspace Settings** > **Members**
2. Click **Invite Member** to add a new team member
3. Assign a role to control their permissions

| Role       | Permissions                                                           |
| ---------- | --------------------------------------------------------------------- |
| **Owner**  | Full access to all workspace settings, billing, and member management |
| **Admin**  | Manage devices, applications, modules, and media                      |
| **Member** | View and interact with devices and applications                       |

## Workspace tokens

Workspace tokens provide API access for tools like [BRICKS CLI](/cli) and CI/CD pipelines.

### Generate a token

1. Go to **Workspace Settings** > **API Token**
2. Click **Generate Token**
3. Copy and store the token securely

Use the token with the [BRICKS CLI](/cli):

```bash theme={null}
bricks auth login-token -t <token>
```

<Warning>
  Treat workspace tokens like passwords. Do not commit them to version control or share them publicly.
</Warning>

## One-time passcodes

Generate one-time passcodes for device binding and CLI login:

1. Go to **Workspace Settings** > **Tokens**
2. Click **Generate Passcode**
3. Use the passcode within 5 minutes

Passcodes are used for:

* [Binding devices](/foundation/device-binding) to the workspace
* [Logging in to BRICKS CLI](/cli/authentication)
* [Logging in to CTOR](/ctor/guide/authentication)

## Subscription plans

Manage your workspace subscription and billing:

1. Go to **Workspace Settings** > **Subscription**
2. View your current plan, usage, and limits
3. Upgrade or change your plan as needed

## Workspace settings

Additional workspace configuration options:

* **Workspace name** — Change the display name of your workspace
* **Default environment** — Set the default server environment (production or beta)
* **Device limits** — View the maximum number of devices allowed on your plan
* **Application limits** — View the maximum number of applications allowed on your plan