---
title: Organizations
meta:
    description: Tinybird Organizations provide enterprise customers with a single pane of glass to monitor usage across multiple workspaces.
---

# {% icon name="organization" /%} Organizations

Organizations provide a centralized way of managing workspaces and members in a region. From the **Organization settings** section you can monitor resource usage and check your current plan's usage and billing if you're on a paid plan. See [Plans](../pricing).

The **Organization settings** section consists of the following areas:

* Observability (Org. admins only)
* Workspaces
* Members
* Billing (Org. admins only)
* Managed regions

All workspaces must belong to an organization in Tinybird. See [Workspaces](./workspaces).

## Users and organizations

Users can be members of one or more organizations. A user can only be the admin of one organization.

## Access the organization settings

To access the **Organization settings** screen, log in and select Settings from the sidebar.

## Observability

The **Observability** page shows details about your resource usage, followed by a detailed breakdown of your consumption.

### Usage charts

The following charts are available depending on your plan:

{% table %}
  * Plan
  * Charts
  ---
  * Free
  * Max/Average vCPU time, Max/Average QPS, Max/Average memory, Storage, Accumulated daily requests, Total errors
  ---
  * Developer
  * Max/Average vCPU time, Max/Average QPS, Max/Average memory, Storage, Total errors
  ---
  * Enterprise (Shared infrastructure)
  * Max/Average vCPU time, Max/Average QPS, Max/Average memory, Storage, Total errors
  ---
  * Enterprise (Dedicated infrastructure)
  * Max load, Max QPS, Max memory, Max storage, Data transfer, Total errors
{% /table %}

You can select between average and maximum values for all usage charts, as well as the period, from **Last hour** to **Last 7 days**.

### Usage table
 
The **Usage** table shows resource usage by Workspace or resource. You can filter by resource name by typing in the text box. 

### Refreshing your organization's Observability token

If your organization's observability Token gets compromised or is lost, refresh it using the following endpoint:

`/v0/organizations/<organization-id>/tokens/Observability%20%28builtin%29/refresh?token=<your-user-token>`

You must use your `user token` for this call, which you can copy from any of your workspaces.

## Workspaces

The **Workspaces** page shows details of all your workspaces, including their name, members, and resources used by each Workspace.

New workspaces created by a user with an email domain linked to, or matching an organization are automatically added to that organization.

## Members

The **Members** page shows details of your organization members, the workspaces they belong to, and their roles. From this page you can manage existing members, their permissions, or invite new members.

The table shows the following information:

* Email
* workspaces and roles

To view the detail of a member’s workspaces and roles, select the arrow next to the Workspace count. A menu shows all the workspaces that user is part of, plus their role in each Workspace.

To change a user’s role or remove them from a Workspace, hover over the Workspace name and follow the arrow. Select a new role from **Admin** or **Viewer**, or remove them from the Workspace. You don't need to be a user in that Workspace to make changes to its users.

### Add or remove members

To add a user, select **Add member**.

To remove a user from the organization, select **Remove member** in the menu. 

{% callout type="info" %}
Only organization administrators can manage users in the **Members** page.
{% /callout %}

### Add an organization admin

To add another user as an organization administrator, follow these steps:

1. Navigate to the **Organization settings** page.
2. Go to the **Members** section.
3. Locate the user you want to make an administrator.
4. Select the **More actions (⋯)** icon.
4. Select **Organization admin** in the menu.

This grants organization administrator access to the selected users.

## Billing

The **Billing** page contains a summary of the credits balance for your plan, with links to billing details and a summary of your plan. See [Billing](../pricing).

From the **Billing** page you can upgrade or resize your plan, or cancel it if you wish to downgrade to Free. 

If you're on a Developer plan, the usage diagram shows the total expenditure by monthly invoice.

{% callout type="info" %}
Only organization administrators can access the **Billing** section.
{% /callout %}

## Managed regions

The **Managed regions** page shows the self-managed regions where your organization has workspaces. See [Self-managed regions](/forward/install-tinybird/self-managed).

### Add a region

To add a region, select **Add region**.

### Remove a region

To remove a region, select the **More actions (⋯)** and then select **Delete**.