---
title: tb workspace
meta:
    description: Manage your Tinybird workspaces
---

# tb workspace

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

{% callout type="info" %}
`tb workspace` is cloud-only. Workspace operations run against Tinybird Cloud account/workspace metadata.
{% /callout %}

The following subcommands are available:

{% table %}
  * Subcommand
  * Description
  ---
  * 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.
{% /table %}

## tb workspace create

Creates a new workspace for your Tinybird user.

{% table %}
  * Option
  * Description
  ---
  * --organization-id TEXT
  * When passed, the workspace will be created in the specified organization 

{% /table %}

## tb workspace delete

Deletes a workspace where you are an admin.

{% table %}
  * Option
  * Description
  ---
  * --yes
  * Don't ask for confirmation.
{% /table %}

## tb workspace members add

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

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

## tb workspace members rm

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

{% table %}
  * Option
  * Description
  ---
  * --user_token TEXT
  * When passed, Tinybird won't prompt asking for it.
{% /table %}

## tb workspace members set-role

Sets the role for existing workspace members.

{% table %}
  * Option
  * Description
  ---
  * --user_token TEXT
  * When passed, Tinybird won't prompt asking for it.
{% /table %}

## tb workspace use

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

{% table %}
  * Option
  * Description
  ---
  * --user_token TEXT
  * When passed, Tinybird won't prompt asking for it.
{% /table %}

## Deprecated alias

`tb workspace clear` is deprecated. Use `tb branch clear` instead.

## Environment support

{% table %}
  * Environment
  * Supported
  * Description
  ---
  * `--local`
  * ✗ No
  * Workspace commands are cloud-only.
  ---
  * `--cloud`
  * ✓ Yes
  * Manages workspaces in Tinybird Cloud.
  ---
  * `--branch=BRANCH_NAME`
  * ✗ No
  * Workspace commands are not branch-scoped.
{% /table %}