Workspaces¶
What is a Workspace?¶
A Workspace is an area that contains a set of Tinybird resources, including Pipes, Nodes, APIs, Data Sources & Auth Tokens.
What should I use Workspaces for?¶
Workspaces allow you to separate the different things you work on in Tinybird.
You can choose exactly how you organise your Workspaces, but the two common ways are a Workspace per project, or per team.
Creating Workspaces¶
You can create multiple Workspaces and doing so is easy. When you create a Workspace, you can start building immediately; there is no delay waiting for clusters to build.
Creating Workspaces in the UI¶
This section describes how to create a Workspace in the UI.
In the top left corner of the Tinybird UI you’ll see the name of your current Workspace.
To create a new Workspace, click on the name of the existing Workspace in the top left corner.

You’ll see a drop down that lists all of your active Workspaces.
Click the + icon as shown below.

This will open a dialog window with a form to help you create a new Workspace. You can give the Workspace a name by typing into the Workspace name box (see Mark 1 below).
If you want to use a Starter Kit, select it from the Starter kit dropdown (see Mark 2 below). When you’re happy, click Create Workspace (see Mark 3 below).

Creating Workspaces in the CLI¶
This section describes how to create a Workspace in the CLI.
To create a new Workspace from the CLI, you can use the following command:
tb workspace create
You can use this command interactively or by providing the required inputs with flags.
To use it interactively, just run the command without any flags (e.g. tb workspace create
).
You will see several prompts that you need to complete.
First, you’ll be asked to supply your User Auth Token.
To get your User Auth Token, see Getting your User Auth Token.
Paste the token into the prompt.
In order to create a new workspace we need your user token. Copy it from https://ui.tinybird.co/tokens and paste it here:
You can select whether you want to use a Starter Kit for your new Workspace. Using the blank
option will give you an empty Workspace.
------------------------------------------------------------------------------------
| Idx | Id | Description |
------------------------------------------------------------------------------------
| 1 | blank | Empty workspace |
| 2 | web-analytics | Starting workspace ready to track visits and custom events |
------------------------------------------------------------------------------------
[0] to cancel
Use starter kit [1]: 1
Next, you’ll be asked to supply a name for your Workspace.
Workspace name [new_workspace_9479]: internal_creating_new_workspaces_example
A successful creation will give you the following output:
** Workspace 'internal_creating_new_workspaces_example' has been created
If you’re using the CLI in an automated system, you probably don’t want to use the interactive command. You can instead provide these options as flags:
tb workspace create --user_token <your_token> --starter-kit 1 internal_creating_new_workspaces_example
Deleting Workspaces¶
Deleting a Workspace deletes all resources within the Workspace, including Data Sources, any ingested data, Pipes and published APIs.
Deleted Workspaces cannot be recovered, so take care with this operation.
Deleting Workspaces in the UI¶
This section describes how to delete a Workspace in the UI.
To delete a Workspace in the UI, click on the Cog icon at the top of the left side navigation bar, next to the Workspace name (see Mark 1 below).

This will open a dialog window. Click the three dots next to the Workspace name (see Mark 1 below). In the context menu, click Delete (see Mark 2 below).

Finally, you will be asked to confirm that you want to delete the Workspace. If you are sure, click Delete to finish deleting the Workspace.

Deleting Workspaces in the CLI¶
This section describes how to delete a Workspace in the CLI.
To delete a Workspace in the CLI, you can use the following command:
tb workspace delete
You will need to provide the name of the Workspace & your User Auth Token token, for example:
tb workspace delete my_workspace --user_token <your User Auth Token>
Managing Workspace users¶
User access to resources in Tinybird are controlled at the Workspace level.
You can invite as many users to a Workspace as you want, and a user can belong to multiple Workspaces.
There are two roles available, Guest and Admin, which can be assigned to a user and changed at any time. Admin users can invite new members to the Workspace and see billing information.
Adding Workspace users in the UI¶
This section describes how to invite new users to your Workspace in the Tinybird UI.
In the top left corner of the Tinybird UI, click the Cog icon (see Mark 1 below).

This will open a dialog window. At the bottom of the dialog window, you can see the users that are already members of your Workspace (see Mark 1 below).
You can add new members by clicking the Add members button (see Mark 2 below).

A text dialog will open. Enter the email address for the user you want to invite in the text area (see Mark 1 below) and then click the Add button (see Mark 2 below). You can invite multiple users at the same time by adding multiple email addresses separated by a comma.
The users you invite will get an email notifying them that they have been invited. If the user does not already have a Tinybird account, they will be prompted to create one to accept your invite.

Invited users will appear in the user management dialog (see Mark 1 below). By default, they will have the Guest role (see Mark 2 below). If the user loses their invite link, you can resend it here too (see Mark 3 below).

Adding Workspace users in the CLI¶
This section describes how to invite new users to your Workspace in the Tinybird CLI.
To add new users, you can use the following command:
tb workspace members add
You will need to supply your User Auth Token with the --user_token
flag.
To get your User Auth Token, see Getting your User Auth Token.
Add the email address of the user you want to invite as the final argument to the command.
tb workspace members add --user_token <your token> my_new_team_member@example.com
A successful invite will give you the following output:
** User my_new_team_member@example.com added to workspace 'internal_getting_started_guide'