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.

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.

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 the settings icon.

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:

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

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

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.

Managed regions¶

The Managed regions page shows the self-managed regions where your organization has workspaces. See Self-managed regions.

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.