Last update: 2025-12-18T21:56:34.000Z
Content:
---
title: "tb workspace · Tinybird Docs"
theme-color: "#171612"
description: "Manage your Tinybird workspaces"
inkeep:version: "forward"
---




# tb workspace [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-workspace#tb-workspace)

Copy as MD Manage your workspaces. Global options apply to this command. See [Global options](/docs/forward/dev-reference/commands/global-options).

The following subcommands are available:

| Subcommand | Description | clear [OPTIONS] | Clear a workspace. Only available against Tinybird Local. |
| --- | --- | --- | --- |
| create [OPTIONS] WORKSPACE_NAME | Creates a new workspace for your Tinybird user. |  |  |
| current | Shows the workspace you're currently authenticated to. |  |  |
| delete [OPTIONS] WORKSPACE_NAME_OR_ID | Deletes a workspace where you are an admin. |  |  |
| ls | Lists all the workspaces you have access to in the account you're currently authenticated to. |  |  |
| members add [OPTIONS] MEMBERS_EMAILS | Adds members to the current workspace. |  |  |
| members ls [OPTIONS] | Lists members in the current workspace. |  |  |
| members rm [OPTIONS] | Removes members from the current workspace. |  |  |
| members set-role [OPTIONS] [guest|viewer|admin] MEMBERS_EMAILS | Sets the role for existing workspace members. |  |  |
| use WORKSPACE_NAME_OR_ID | Switches to another workspace. Use `tb workspace ls`   to list the workspaces you have access to. |  |  |

## tb workspace create [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-workspace#tb-workspace-create)

Creates a new workspace for your Tinybird user.

| Option | Description |
| --- | --- |
| --organization-id TEXT | When passed, the workspace will be created in the specified organization |

## tb workspace delete [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-workspace#tb-workspace-delete)

Deletes a workspace where you are an admin.

| Option | Description |
| --- | --- |
| --yes | Don't ask for confirmation. |

## tb workspace members add [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-workspace#tb-workspace-members-add)

Adds members to the current workspace. Takes a list of members emails as an argument.

| Option | Description |
| --- | --- |
| --role [guest|viewer|admin] | Sets the role for the members. |
| --user_token TEXT | When passed, Tinybird won't prompt asking for it. |

## tb workspace members rm [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-workspace#tb-workspace-members-rm)

Removes members from the current workspace. Takes a list of members emails as an argument.

| Option | Description |
| --- | --- |
| --user_token TEXT | When passed, Tinybird won't prompt asking for it. |

## tb workspace members set-role [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-workspace#tb-workspace-members-set-role)

Sets the role for existing workspace members.

| Option | Description |
| --- | --- |
| --user_token TEXT | When passed, Tinybird won't prompt asking for it. |

## tb workspace use [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-workspace#tb-workspace-use)

Switches to another workspace. Use `tb workspace ls` to list the workspaces you have access to.

| Option | Description |
| --- | --- |
| --user_token TEXT | When passed, Tinybird won't prompt asking for it. |

## Environment support [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-workspace#environment-support)

| Environment | Supported | Description |
| --- | --- | --- |
| `--local` | ✓ Yes (default) | Manages workspaces in Tinybird Local. |
| `--cloud` | ✓ Yes | Manages workspaces in Tinybird Cloud. `clear`   command not supported. |
| `--branch=BRANCH_NAME` | ✓ Yes | Manages workspaces in a branch. `clear`   command not supported. |


