A workspace in BRICKS Controller is the top-level container for your devices, applications, modules, and team members.
Creating a workspace
- Log in to BRICKS Controller
- Click Create Workspace
- Enter a workspace name
- Choose a subscription plan
Members and roles
Manage who has access to your workspace and what they can do:
- Go to Workspace Settings > Members
- Click Invite Member to add a new team member
- 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 and CI/CD pipelines.
Generate a token
- Go to Workspace Settings > API Token
- Click Generate Token
- Copy and store the token securely
Use the token with the BRICKS CLI:
bricks auth login-token -t <token>
Treat workspace tokens like passwords. Do not commit them to version control or share them publicly.
One-time passcodes
Generate one-time passcodes for device binding and CLI login:
- Go to Workspace Settings > Tokens
- Click Generate Passcode
- Use the passcode within 5 minutes
Passcodes are used for:
Subscription plans
Manage your workspace subscription and billing:
- Go to Workspace Settings > Subscription
- View your current plan, usage, and limits
- 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
