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

# Créer une clé API

> Créez une clé à portée minimale pour appeler Zelinqa depuis votre backend.

Les clés Zelinqa sont des secrets **backend uniquement**. Elles identifient automatiquement votre organisation et votre domaine : vous ne transmettez jamais de `tenant_id` fiable depuis le client.

## Choisir les droits

| Scope | Usage |
| - | - |
| `runtime` | Créer et faire progresser des sessions, lire leur état et envoyer un feedback. |
| `configuration:read` | Lire la configuration publiée, les questions et le statut de compilation. |
| `configuration:write` | Lire et modifier le brouillon. |
| `configuration:publish` | Publier et consulter le journal d'audit. À combiner avec `configuration:read` pour suivre la compilation. |

Pour une intégration conversationnelle, créez une clé contenant uniquement `runtime`. Séparez les clés de production, de test et d'administration.

<Steps>
  <Step title="Ouvrir Clés API">
    Dans Zelinqa Studio, sélectionnez le domaine concerné puis ouvrez **Clés API**.
  </Step>

  <Step title="Créer la clé">
    Choisissez les droits strictement nécessaires. La clé complète n'est affichée qu'une seule fois.
  </Step>

  <Step title="Stocker le secret">
    Copiez-la dans le gestionnaire de secrets de votre backend, jamais dans le navigateur ou le dépôt Git.
  </Step>
</Steps>

```bash theme={null}
export ZELINQA_API_KEY="nbq_live_xxx"
```

<Warning>
  Une clé perdue ne peut pas être relue. Révoquez-la et créez-en une nouvelle. Une révocation prend effet immédiatement.
</Warning>


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