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

# Phone numbers

> Numbers belong to the organization and are assigned to a workspace.

Every phone number your agents call from or answer on lives in the **Phone Numbers**
page. A number is owned by the **organization** and assigned to **one workspace** at a
time, so a team can hold its numbers in one place and hand them out as work moves
between workspaces.

<Note>
  Phone numbers used to be connected and managed per workspace. They are now
  organization-owned. If you connected a carrier before this change, your numbers were
  kept and assigned to the workspace that had them.
</Note>

## Where numbers come from

<CardGroup cols={2}>
  <Card title="Your own carrier account" icon="plug" href="/phone-numbers/carrier-accounts">
    Connect a Plivo or VoBiz account you already pay for, then import its numbers.
    Your carrier bills you directly.
  </Card>

  <Card title="Rented from Vocily" icon="shopping-cart" href="/phone-numbers/rent-from-vocily">
    Buy a number inside Vocily with no carrier account of your own. Vocily bills it to
    your wallet.
  </Card>
</CardGroup>

Both kinds sit in the same list. A number's **Source** column says which it is -
`Own account` or `Rented` - because the available actions differ: only a rented number
can be released back to the provider, and only a rented number carries a monthly charge
from Vocily.

There is also a third, which you do not own: the shared
[Vocily Test Number](/test/test-number). It appears in every workspace so you can place
outbound test calls before you have a number of your own. It is not part of your
organization's inventory - it cannot be assigned, transferred, released, or used for
inbound - so it does not appear in the Organization view.

## The two views

The Phone Numbers page has an **Organization / Workspace** toggle in the top right.

| View             | Answers                                                                 | Who sees it                    |
| ---------------- | ----------------------------------------------------------------------- | ------------------------------ |
| **Organization** | What do we own, where did it come from, and which workspace holds it?   | Owners and Admins              |
| **Workspace**    | What can this workspace call from, and which agent answers each number? | Everyone with workspace access |

Members and Viewers see only the Workspace view, with no toggle.

## Organization view

The Organization view is where the inventory changes. It has two sections:

* **Carrier accounts (BYOC)** - the Plivo or VoBiz accounts you have connected.
* **Organization phone numbers** - every number the organization owns, and the workspace
  holding each.

Each column header in the numbers table filters or sorts that column: search by number,
filter by source, compliance, workspace or status, and sort by when the number was added.

### What each action does

| Action                        | Effect                                                               | Reversible            |
| ----------------------------- | -------------------------------------------------------------------- | --------------------- |
| **Unassign**                  | Returns the number to the organization pool. The rental continues.   | Yes - assign it again |
| **Remove** (own account only) | Drops the number from Vocily. It stays live on your carrier account. | Yes - import it again |
| **Release** (rented only)     | Gives the number back to the provider and stops the monthly charge.  | **No**                |

### A number in use cannot be moved

Moving or unassigning a number is refused while anything still points at it:

* an agent answering inbound calls on it,
* an agent using it as their default outbound number,
* a batch still calling from it.

Vocily lists exactly what is in the way and asks you to detach those first. It will not
quietly clear them for you - moving a number out from under a live agent changes which
team answers a caller, and doing that silently is how a support line starts ringing into
sales with nobody noticing.

## Workspace view

The Workspace view is read-only. It lists the numbers assigned to the workspace you are
in, which agent answers each one, and whether the number is currently active at the
carrier.

Attaching an agent to a number is done from the agent's
[Deploy](/building-agents/deploy) tab, not here.

## Who can do what

| Action                                      | Owner | Admin | Member | Viewer |
| ------------------------------------------- | :---: | :---: | :----: | :----: |
| View the workspace's numbers                |  Yes  |  Yes  |   Yes  |   Yes  |
| Connect or disconnect a carrier account     |  Yes  |  Yes  |   No   |   No   |
| Import a number, assign, unassign, transfer |  Yes  |  Yes  |   No   |   No   |
| Rent a number, release a rented number      |  Yes  |   No  |   No   |   No   |
| Add or submit a compliance application      |  Yes  |   No  |   No   |   No   |

Renting and releasing spend real money on Vocily's provider account, and a compliance
application is a legal statement made in your business's name - so both are limited to
Owners. Allocating a number that already exists is an Admin action.

## What's next

* Connect an account you already own in [Carrier accounts](/phone-numbers/carrier-accounts).
* Buy a number in [Rent a number from Vocily](/phone-numbers/rent-from-vocily).
* File Indian KYC in [Compliance](/phone-numbers/compliance).
* Route calls to an agent in [Deploy](/building-agents/deploy).