---
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 is only available to Organization admins. It consists of the following areas:

* Billing
* Usage
* Workspaces
* Members
* Monitoring

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

Tinybird represents organizations using the {% icon name="organization" /%} icon.

## 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 your organization name from a Workspace.

![Organization settings](/img/your-organization.png)

You can also access the screen by selecting **Organization settings** in the settings screen of a Workspace.

## 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).

### Free and Developer plans

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.

### Enterprise plans

The **Credits usage** section shows a chart with your credits usage over time and a forecast.

![Credits usage](/img/credits-usage-new.png)

## Usage overview

The **Usage** 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
  ---
  * SaaS
  * 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. 

## 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**, **Guest**, 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.


## Monitoring

The Monitoring page provides customized code snippets to monitor usage using the Tinybird API and the Service Data Sources. See [Organization Service Data Sources](../monitoring/service-datasources#organization-service-data-sources).

### Prometheus metrics endpoint
The Prometheus endpoint is available at /v0/metrics. Use your organization's observability Token, which you can find in the Prometheus tab under Monitoring, Organization settings.

Tinybird reports all the metrics available in the service Data Source, except for InstanceType, which is reported as a metric label.

### 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.