> ## 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.

# Clés API

> Créez et gérez vos clés API Bookivox pour piloter la plateforme par API REST ou via le serveur MCP.

## Créer une clé API

**1. Ouvrir les clés API**

Allez dans **Clés API**.

**2. Créer une clé**

Cliquez sur **Créer une clé** et donnez-lui un **nom** mémorable
(par exemple : « Intégration CRM »).

**3. Copier immédiatement**

La clé complète n'est affichée qu'**une seule fois**, à la création.
**Copiez-la tout de suite** et rangez-la dans un gestionnaire de secrets.

**4. Utiliser la clé**

Passez-la dans l'en-tête **`X-API-Key`** de vos requêtes à l'API REST, ou
déclarez-la dans votre client **MCP**.

## À quoi sert une clé API

| Usage | Détail |
| - | - |
| **API REST** | Toutes les routes sous `/api/v1/api` (voir [Référence API](https://docs.bookivox.com/api-reference/overview)) |
| **Serveur MCP** | Connexion des agents IA (voir [Intégration MCP](https://docs.bookivox.com/mcp/overview.md)) |

## Sécurité

> [!WARNING]
>
> * Une clé API est un **secret** : ne la committez **jamais** dans un dépôt Git
>   et ne la collez pas dans un chat.
> * Utilisez **une clé par intégration** : en cas de fuite, vous en révoquez une
>   seule.
> * Appliquez le **moindre privilège** : limitez les scopes quand c'est possible.
> * **Révoquez** immédiatement toute clé compromise, puis créez-en une nouvelle.
> * Ne transmettez pas une clé à un contenu que lit un agent IA (risque
>   d'exfiltration via injection de prompt).

> [!NOTE]
>
> Certaines actions sont **bloquées via une clé API** pour des raisons de
> sécurité (facturation, provisionnement de numéros) : elles doivent être
> effectuées dans l'interface. L'API renvoie alors un code `403`.

> **[Référence API](https://docs.bookivox.com/api-reference/overview)**
>
> Utiliser votre clé avec l'API REST.

> **[Intégration MCP](https://docs.bookivox.com/mcp/overview.md)**
>
> Connecter un agent IA.


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