# Gestion des clés API

Les clés API permettent à des outils externes et à des automatisations d’interagir avec votre espace de travail de façon programmatique. Les administrateurs de l’espace de travail peuvent créer, voir et révoquer les clés à tout moment.

### Créer une clé API

Allez à **Paramètres → API → Clés** et cliquez sur **Nouvelle clé API**. Donnez à la clé un nom descriptif (par exemple « intégration CI/CD » ou « tableau de bord interne ») afin de pouvoir l’identifier plus tard.

{% hint style="warning" %}
Copiez votre clé juste après sa création — elle ne sera plus affichée. Si vous la perdez, vous devrez la révoquer et en créer une nouvelle.
{% endhint %}

### Autorisations de la clé

Lors de la création d’une clé, vous pouvez définir l’étendue de ses autorisations :

| Autorisation | Ce qu’elle permet                                               |
| ------------ | --------------------------------------------------------------- |
| **Lecture**  | Récupérer le contenu, les paramètres et les données des membres |
| **Écriture** | Créer et mettre à jour le contenu                               |
| **Admin**    | Gérer les paramètres, les membres et la facturation             |

Utilisez le minimum d’autorisations nécessaire pour chaque intégration.

### Faire tourner une clé

Pour faire tourner une clé, créez-en une nouvelle, mettez à jour votre intégration pour l’utiliser, puis révoquez l’ancienne clé. Il n’y a pas de rotation automatique — c’est un processus manuel.

### Révoquer une clé

Allez à **Paramètres → API → Clés**, trouvez la clé, puis cliquez sur **Révoquer**. La révocation est immédiate — toute requête qui utilise cette clé échouera aussitôt.

### Suivre l’utilisation

Sous **Paramètres → API → Utilisation**, vous pouvez voir le nombre de requêtes par clé sur les 30 derniers jours. Cela est utile pour repérer une utilisation inattendue ou identifier les intégrations les plus actives.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://sexytrees.savimbo.com/practice-guide/fr/iteration/gestion-des-cles-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
