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

# Clés API

> Créez une clé limitée pour vos scripts et vos outils de reporting.

## Créer une clé

1. Connectez-vous et ouvrez [Settings → Integrations](https://app.tryvoicestudio.com/external/settings/integrations).
2. Sélectionnez **Create key** et donnez un nom qui identifie l’outil.
3. Choisissez votre entreprise, tous ses projets ou une liste précise, puis les permissions nécessaires.
4. Choisissez une expiration, puis sélectionnez **Create key**.
5. Copiez le secret affiché et conservez-le dans les paramètres sécurisés de votre outil.

Le secret complet n’est affiché qu’une fois. VoiceStudio conserve son empreinte. Si vous le perdez, révoquez l’ancienne clé et créez-en une nouvelle.

## Envoyer une requête

Définissez `VOICESTUDIO_API_KEY` dans votre environnement ou votre gestionnaire de secrets. Transmettez-la dans l’en-tête `x-api-key` :

```bash theme={null}
curl 'https://api.tryvoicestudio.com/v1/projects?limit=25' \
  -H "x-api-key: $VOICESTUDIO_API_KEY"
```

Vous pouvez utiliser `Authorization: Bearer VOTRE_CLE` à la place de `x-api-key`. Envoyez un seul en-tête d’identification par requête.

## Modifier ou révoquer les accès

La page des intégrations affiche les permissions, la dernière utilisation et l’expiration de chaque clé. Pour modifier les accès, révoquez la clé et créez-en une nouvelle. Les requêtes suivantes seront refusées après révocation.

Une clé appartient au compte qui l’a créée. Le retrait de son accès à l’entreprise, sa suspension ou un changement de rôle de validation peuvent empêcher son utilisation.

<Warning>
  Ne placez jamais une clé dans du code navigateur, un dépôt Git ou une
  conversation. Préférez OAuth pour les assistants qui le prennent en charge.
</Warning>


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