# Lines

Create, update, and delete an application's external lines, plus read the list of lines rented from Voximplant or connected over SIP.

Bitrix24 API: `telephony.externalLine.*`, `voximplant.line.get`
Scope: `telephony`

## Operations

- [List application lines](./lines/list.md) — `GET /v1/telephony-lines`
- [Add a line](./lines/create.md) — `POST /v1/telephony-lines`
- [Update a line](./lines/update.md) — `PATCH /v1/telephony-lines/:number`
- [Delete a line](./lines/delete.md) — `DELETE /v1/telephony-lines/:number`
- [Voximplant lines](./lines/voximplant.md) — `GET /v1/voximplant-lines`

## What you need to know

Two endpoints return lines from different sources:
- `GET /v1/telephony-lines` — lines **added by the application** via `POST /v1/telephony-lines`. Relevant for applications connecting their own PBX to the Bitrix24 account.
- `GET /v1/voximplant-lines` — lines **rented from Voximplant** or connected over SIP, visible to the Bitrix24 account. Read-only.

The application line identifier is the `number` string set at creation. The update and delete URLs use exactly this value (URL-encode special characters).

## See also

- [Telephony — overview](../telephony.md)
- [Outbound calls](./outbound.md) — lines are used as `fromLine`