> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.toloka.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Teams, access, and balance

> Manage team access in the Business Console, switch teams, add funds or promocodes, and view billing history.

The sidebar shows which team you are working in, that team's access level, and its balance. You can switch teams, read the access badges, see the shared balance, top up, apply a promocode, and open billing history.

The agent has no commands for team membership or balance. Adding money and adding company members take place in the Business Console. **Top up** and **Billing history** open it in a new tab.

## Teams

A [team](https://docs.platform.toloka.ai/docs/start/glossary.md#team) is the account unit that owns your projects and one balance. Data Labeling pipeline runs and Training Runs use that balance under their own product-specific billing rules.

You work in one team at a time. A team can be your own personal team or one shared with other people, and you may belong to several.

### Switch teams

The team switcher sits at the top of the sidebar on your project list and shows the team you are in now; inside a project there is no switcher. Your own personal team reads **Personal**, and a read-only team carries a **Read only** badge.

Open the switcher to see every team you can reach. Each row shows the team's name and one access badge, **Full access** or **Read only**. Your personal team also carries **Your**. Selecting a team takes you to that team's project list.

On sign-in the platform selects a team for you: the one you used last, then your personal team, then your first available team. There is no team-choosing screen. See [the tutorial's sign-in step](https://docs.platform.toloka.ai/docs/data/get-started/first-labeled-dataset.md#step-1--sign-in).

### Read-only access

Your access to a shared team is either full or read-only, and the switcher badge tells you which. Full access lets you do everything on the team. Read-only access lets you open and read everything the team owns, including projects, pipelines, runs, datasets, and results. It does not let you change them.

On a read-only team these write controls are hidden outright:

* create a project
* add a secret
* chat with the agent (the chat input and the new-chat button are gone)
* apply a promocode or top up (**Apply promocode** and **Top up** are removed from the **Balance** menu)
* edit a message you already sent to the agent

Reads work as normal, and **Billing history** stays available. Other changes, including editing a pipeline, deploying, and uploading data, stay visible but are refused. What you see depends on your other teams: if every team you belong to is read-only, the refusal reads "You do not have access to this resource"; if you also have a full-access team elsewhere, the resource is masked instead and the toast says it was not found.

### When you have no team access

If you belong to no team, you land on the **Waiting for access** page. Ask a teammate with **Full access** to add you — see [Give someone access](#give-someone-access).

If a team is missing from the switcher, ask its owner or Toloka support to check your access.

## Give someone access

Grant access in the Business Console, the same application **Top up** opens. The platform does not add members; it reads the membership after you save it.

The colleague must already have a Toloka account. You must have **Full access** on the company. A **View only** member does not see the **Share access** tab.

Adding a company member with **Full access** grants write access on all of that company’s teams and projects. To grant only one team, open that team’s **Share access** tab and click **Add team member**, with the same **Full access** and **View only** options.

1. Ask the colleague to open [https://console.toloka.ai/profile](https://console.toloka.ai/profile). The heading is **Profile**. Under **Personal data**, copy **Login** with **Copy Login**. If the page shows hyphens in the login, the control copies the value without them.
2. Open [https://console.toloka.ai/companies](https://console.toloka.ai/companies). The heading is **Companies**. Open the company.
3. Open the **Share access** tab.
4. Click **Add company member**. The **Add company member** dialog opens.
5. Paste the login into **Login or email**. Leave **Full access** selected to give write access; that is the default. Choose **View only** for read-only access. On the platform, that member’s badge reads **Read only**.
6. Click **Add member**. **Cancel** closes the dialog without adding the member.

**Account not registered** means that login does not match a Toloka account. Copy **Login** from **Profile** again. **You can’t add this account to the company** appears if you add your own account; use the colleague’s login.

If they already have **View only**, they already appear in the member list on the **Share access** tab. Open **Edit access** on that row, choose **Full access**, and click **Save**.

A colleague who already belongs to another team will not land on **Waiting for access**. They open the team switcher on the project-list sidebar and select the new team.

## Your balance

The sidebar shows a **Balance** item with the team's current balance beside it, in US dollars. An empty balance reads `$0.00`.

The team owns the balance, and all of its projects share it. [Billing](https://docs.platform.toloka.ai/docs/core/billing.md) explains the common balance flow and the distinct reserve, charge, release, and pause rules for pipeline runs and Training Runs.

Click **Balance** to open its menu. On a full-access team the menu has three items — **Apply promocode**, **Top up**, and **Billing history**. On a read-only team it shows only **Billing history**. The balance amount is always visible.

![The Balance menu on a full-access team: Apply promocode, Top up, and Billing history.](https://mintcdn.com/toloka-platform/e2y6apyB8pyO00uJ/images/how-to/account-team-balance/balance-menu.png?fit=max\&auto=format\&n=e2y6apyB8pyO00uJ\&q=85\&s=7ffd46cce94840b6020fd60602ab9f1f)

## Top up

**Top up** opens the Business Console's billing page in a new tab. You add money there, then return to the platform. Payments, invoices, and payment methods live in the Business Console.

When paid work needs more funds, follow its product-specific prompt to this same billing page, then return to the platform. See [Billing](https://docs.platform.toloka.ai/docs/core/billing.md#balance-and-pauses) for the shared top-up path and the separate pipeline and Training recovery flows.

## Apply a promocode

A promocode adds credit to your balance. **Apply promocode** opens a dialog with one field, **Promocode**.

Enter the code and click **Check** to preview it. A valid code shows "The promo is active" in green, with its dollar value when it carries one. An unknown or inactive code shows "The promo code does not exist or is invalid" in red.

The code credits the team you have selected, so switch to the right team first. Then click **Apply**. The dialog closes either way — on success a confirmation appears and the **Balance** amount refreshes; on failure the toast reads "Unable to apply promocode". **Cancel** closes the dialog without applying anything.

You can also enter a code when you register. The registration form has a **Promo code (optional)** field.

## Billing history

Click **Balance → Billing history** to open the Business Console billing page. This is also available to read-only members.

## Related

* [Billing](https://docs.platform.toloka.ai/docs/core/billing.md) — how both products use the shared team balance
* [Pipeline pricing](https://docs.platform.toloka.ai/docs/data/concepts/pricing.md) — forecast and contract mechanics for Data Labeling
* [Training cost](https://docs.platform.toloka.ai/docs/train/concepts/cost.md) — maximum-charge holds and Training settlement
* [Get your first labeled dataset](https://docs.platform.toloka.ai/docs/data/get-started/first-labeled-dataset.md#step-1--sign-in) — signing in and landing in your team


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.