Workspaces¶

A Workspace is a set of Tinybird resources, like Data Sources, Pipes, Nodes, API Endpoints, and Tokens. Workspaces are always created inside organizations. See Organizations.

You can use Workspaces to manage separate projects, use cases, and dev, staging, or production environments in Tinybird. Each Workspace has administrators and members who can view and edit resources.

Tinybird represents Workspaces using the icon.

Create a Workspace¶

To create a new Workspace, select the name of an existing Workspace. In the menu, select Create Workspace (+).

Complete the dialog with the details of your new Workspace, and select "Create Workspace".

Create a Workspace using the CLI¶

To create a new Workspace using the CLI, 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, run the command without any flags. For example, tb workspace create.

Supply your user Token by pasting it into the prompt. Next, supply a name for your Workspace. Workspaces must have unique names within a region.

Workspace name [new_workspace_9479]: internal_creating_new_workspaces_example

When Tinybird creates the Workspace, a message similar to the following appears:

** Workspace 'internal_creating_new_workspaces_example' has been created

If you are using the CLI in an automated system, you can instead pass each value using flags. For example:

tb workspace create --user_token <your_token> --starter-kit 1 internal_creating_new_workspaces_example

Delete a Workspace¶

Deleting a Workspace deletes all resources within the Workspace, including Data Sources, ingested data, Pipes, and published API Endpoints.

To delete a Workspace, select the Settings icon. In the dialog that appears, select Advanced Settings and then select Delete Workspace. Confirm the deletion.

Delete a Workspace using the CLI¶

To delete a Workspace using the CLI, use the following command:

tb workspace delete

Provide the name of the Workspace and your user Token. For example:

tb workspace delete my_workspace --user_token <your user Token>

Manage Workspace members¶

You can invite as many members to a Workspace as you want. A member can belong to multiple Workspaces.

Members always have a role assigned. You can modify the role of a user at any time.

Tinybird has the following member roles for Workspaces:

Manage Workspace members in the UI¶

In the top right corner of the Tinybird UI, select the Cog icon. In the modal, navigate to "Members" to review any members already part of your Workspace.

Add a new member by entering their email address and confirming their role from the dropdown options. 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 they don't already have a Tinybird account, they will be prompted to create one to accept your invite.

Invited users appear in the user management modal and by default have the Guest role. If the user loses their invite link, you can resend it here too, or copy the link to your clipboard. You can also remove members from here using the "..." menu and selecting "Remove".

Adding Workspace users in the CLI¶

To add new users, use the following command:

tb workspace members add

Supply your user Token using the --user_token flag. 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> [email protected]

A successful invite returns the following output:

** User [email protected] added to workspace 'internal_getting_started_guide'

Share Data Sources between Workspaces¶

Sometimes you might want to share resources between different teams or projects. For example, you might have a Data Source of events data that multiple teams want to use to build features with. Rather than duplicating this data, you can share it between multiple Workspaces.

To share a Data Source, follow these steps:

1. Open the Data Source that you want to share.
2. When you hover over the Data Source, select the More actions (⋯) icon.
3. In the menu, select Share.
4. In the Search box, type the name of the Workspace that you want to share the Data Source with. You can only share Data Sources with Workspaces that you are a member of.
5. Select the Workspace. The Workspace appears in the Shared section.
6. Select Done to close the dialog.

Share Data Sources using the CLI¶

To share a Data Source, use the following command:

tb datasource share

Supply your user Token using the --user_token flag. Then, supply the Data Source name and target Workspace name as the following arguments:

tb datasource share --user_token <your_token> shopping_data my_second_workspace

The Data Source that you want to share must exist in the Workspace that your Tinybird CLI is authenticated against. To check which Workspace your CLI is currently authenticated with, use:

tb auth info

You can also run tb push --user_token <your token> to push a Data Source with a SHARED_WITH parameter to share it with another Workspace.

Regions¶

A Workspace belongs to one region. The following table lists the available regions and their corresponding API base URLs:

Tinybird documentation uses https://api.tinybird.co as the default example API base URL. If you are not using the Europe GCP region, replace the URL with the API base URL for your region.

Single Sign-On (SSO)¶

Tinybird provides email and OAuth providers for logging in into the platform.

If you have a requirement for SSO integration, contact Tinybird at [email protected] or in the Community Slack.

Secure cloud connections¶

Tinybird supports TLS across all ingest connectors, providing encryption on the wire for incoming data.

If you have a requirement for secure cloud connections, contact Tinybird at [email protected] or in the Community Slack.