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

# Phone Numbers overview

> Search, buy, connect, inspect, assign, and retire v1 phone numbers.

Phone numbers provide inbound and outbound telephony routes for agents. Purchasing and deleting numbers can affect billing and live routing.

## Choose a provisioning path

| Path                   | Use when                                       | Operations                                                                                               |
| ---------------------- | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Provider inventory     | You want DialNexa to provision a Plivo number. | [Search](/docs/api-reference/v1/phone-numbers/search-plivo), then [Buy](/docs/api-reference/v1/phone-numbers/buy). |
| Bring your own carrier | You already control the number and SIP trunk.  | [Link SIP Trunk](/docs/api-reference/v1/phone-numbers/link-sip-trunk).                                        |

## Lifecycle

* [List](/docs/api-reference/v1/phone-numbers/list) and [get](/docs/api-reference/v1/phone-numbers/get) phone numbers before changing routing.
* Assign inbound or outbound use while publishing an agent version through [Update Agent](/docs/api-reference/v1/agents/update).
* Confirm no active agent or workflow depends on the route before [deleting](/docs/api-reference/v1/phone-numbers/delete).

<Warning>
  Buying a provider number can create a billable rental. A timeout is ambiguous; list workspace numbers before submitting the purchase again.
</Warning>