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

# Téléphonie (API)

> Accès téléphonie via l'API : lecture des configurations et des numéros. Le provisioning et la gestion des numéros sont réservés au dashboard.

## Ce qui est autorisé (lecture)

| Méthode | Endpoint | Description |
| - | - | - |
| `GET` | `/api/v1/api/organizations/telephony-configs` | Lister les configurations téléphonie de l'organisation. |
| `GET` | `/api/v1/api/organizations/telephony-configs/{config_id}` | Lire une configuration. |
| `GET` | `/api/v1/api/organizations/telephony-configs/{config_id}/phone-numbers` | Lister les numéros rattachés à une configuration. |

> [!NOTE]
>
> `config_id` est un **UUID public** opaque (pas l'entier interne).

## Ce qui est bloqué (provisioning)

Pour limiter l'impact d'une fuite de clé, ces opérations sont **interdites** via
clé API et renvoient **`403`** :

* `POST` / `PUT` / `DELETE` sur `telephony-configs` et `phone-numbers` ;
* le **provisioning** (listing fournisseurs, achat de numéros).

> [!WARNING]
>
> Achetez et configurez vos numéros **dans le dashboard**. Voir
> [Téléphonie](https://docs.bookivox.com/telephony/overview.md) et [Acheter un numéro](https://docs.bookivox.com/telephony/buying-numbers.md).

## Voir aussi

* [Aperçu téléphonie](https://docs.bookivox.com/telephony/overview.md)
* [Configurations téléphonie](https://docs.bookivox.com/telephony/configurations.md)


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