# Account Management

The **Accounts** page is the central hub for viewing and managing all your Telegram accounts.

![Accounts table](/files/zr7pRUt3nmDxoFioxVbM)

## Account Table

Every account is shown as a row in the table. Here is what each column means:

| Column       | Description                                                                                                              |
| ------------ | ------------------------------------------------------------------------------------------------------------------------ |
| **#**        | Row number                                                                                                               |
| **Phone**    | The phone number associated with this account, with an avatar initial                                                    |
| **SESS**     | Number of sessions for this phone. One phone can have multiple sessions (from registration, re-authorization, or import) |
| **Status**   | Current account status -- see the status table below                                                                     |
| **Platform** | What platform the account is on: iOS, Android, or Desktop                                                                |
| **Country**  | Registration country, shown as a flag icon and country code                                                              |
| **Name**     | The Telegram display name (first and last name)                                                                          |
| **Username** | The Telegram @username, if the account has one                                                                           |
| **Module**   | The last module that was used on this account (e.g., "reauthorizer", "checker")                                          |
| **Age**      | How long ago the account was created on Telegram                                                                         |
| **Added**    | When the account was added to MVS Web                                                                                    |

All columns are **sortable** -- click any column header to sort the table by that column.

### Status Colors

| Status     | Color  | What It Means                                                                  |
| ---------- | ------ | ------------------------------------------------------------------------------ |
| **alive**  | Green  | Account is active and working normally                                         |
| **frozen** | Yellow | Account is restricted by Telegram (spam flag, scam flag, or other restriction) |
| **banned** | Red    | Account has been banned or deactivated by Telegram                             |
| **dead**   | Gray   | The session is no longer valid (expired or revoked)                            |
| **new**    | --     | Freshly added account that has not been checked yet                            |
| **error**  | --     | Something went wrong during the last operation                                 |

### Status Icons

You may see small icons next to account information:

| Icon             | Meaning                                             |
| ---------------- | --------------------------------------------------- |
| Warning triangle | Account has an active spam block                    |
| Star             | Account has Telegram Premium                        |
| Lock             | Account has 2FA (Two-Factor Authentication) enabled |
| Key              | Account has a FIDO2 passkey stored for recovery     |

## Filtering Accounts

The filter bar at the top lets you narrow down the account list. You can combine multiple filters:

| Filter       | Options                                                       |
| ------------ | ------------------------------------------------------------- |
| **Folder**   | Unsorted, or pick a folder to filter by                       |
| **Platform** | All platforms, Android, iOS, Desktop                          |
| **Source**   | All sources, Registered, Imported, Converted, etc.            |
| **Module**   | All modules, or select one or more modules (multi-select)     |
| **Status**   | All statuses, Alive, Frozen, Banned, Dead, New, Error         |
| **Country**  | All countries, or select one or more countries (multi-select) |
| **Premium**  | All, Premium only, Non-premium only                           |
| **2FA**      | All, With 2FA, Without 2FA                                    |
| **Spam**     | All, With spam block, Without spam block                      |
| **Export**   | Not exported, Exported                                        |
| **Search**   | Type to search by phone, name, or username                    |

The account count updates in real time as you apply filters (e.g., "Found: 718").

### Pagination

At the bottom of the table, you can choose how many accounts to display per page: **25**, **50**, or **100**. Navigation buttons let you move between pages.

## Selecting Accounts

There are three ways to select accounts:

1. **Checkbox** -- Click the checkbox next to individual accounts
2. **Shift+Click** -- Hold Shift and click to select a range of accounts
3. **Range selector** -- Use the **From** and **To** fields to select a range of rows (e.g., rows 1 to 20)
4. **Select All** -- Click **All (718)** to select all accounts matching your current filters

Selected accounts can then be used when starting a module task, or for bulk actions.

## Account Details

Click on any account row to open its **detail card**.

![Account detail](/files/oRChZalbJB6f6TmjAeuB)

The detail card shows all information about the account:

| Field              | Description                                           |
| ------------------ | ----------------------------------------------------- |
| **Phone**          | Phone number (with copy button)                       |
| **Platform badge** | iOS, Android, or Desktop                              |
| **Status badge**   | Current status (Alive, Dead, etc.)                    |
| **Country flag**   | Registration country                                  |
| **Tag**            | Custom tag you can set (e.g., "archived", "sold")     |
| **Username**       | Telegram @username (clickable link)                   |
| **Telegram ID**    | Numeric Telegram user ID (with copy button)           |
| **2FA**            | Two-factor authentication password (with copy button) |
| **Status**         | Current account status                                |
| **Source**         | How the account was added                             |
| **Country**        | Full country name                                     |
| **Age**            | Account age                                           |
| **Language**       | Language code (e.g., "es (es-ES)")                    |
| **Lang Pack**      | Language pack (e.g., "ios")                           |
| **Device**         | Device model (e.g., "iPhone 13")                      |
| **OS / SDK**       | Operating system version                              |
| **App Version**    | Telegram app version                                  |

### Action Buttons

At the bottom of the detail card, you will find action buttons:

| Button           | What It Does                                            |
| ---------------- | ------------------------------------------------------- |
| **Save** (green) | Save any changes you made to the account (like the tag) |
| **Check**        | Run a quick check on this single account                |
| **Clean**        | Run the cleaner on this single account                  |
| **Web**          | Open Telegram Web logged in as this account             |
| **Delete** (red) | Permanently remove this account from the database       |

### History

Click the **History** section to expand it and see all past events for this account -- when it was checked, cleaned, profile-edited, etc.

![Account history](/files/clPcfQpjShK49uSMsyCF)

Each history entry shows the date, module name, and result.

## Bulk Actions

When you have accounts selected, the following bulk actions are available:

| Action            | What It Does                                        |
| ----------------- | --------------------------------------------------- |
| **Delete**        | Remove all selected accounts from the database      |
| **Change Status** | Manually set a new status for all selected accounts |
| **Set Tag**       | Apply a tag/label to all selected accounts          |
| **Set 2FA**       | Set a 2FA password for all selected accounts        |

{% hint style="warning" %}
**Deleting accounts is permanent.** There is no undo. Make sure you really want to remove them before confirming.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mvs-3.gitbook.io/mvs-docs/accounts/account-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
