# Clés d’API et personne pour qui l’appel est fait

Chaque code de cette famille : ce qu’il veut dire, sa cause la plus fréquente, quoi faire et qui peut le faire.

[Tous les codes d’erreur](https://www.azothos.ai/fr/docs/errors)

### `api_key_invalid`

- **Ce que ça veut dire**: La clé d’API Azoth envoyée avec l’appel ne correspond à aucune clé active.
- **Cause la plus fréquente**: Une clé révoquée ou expirée, ou une clé copiée avec un caractère en moins.
- **Quoi faire**: Cette clé API Azoth n’est pas valide (révoquée, expirée ou mal copiée). Créez-en une nouvelle dans Réglages › Accès.
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/settings?section=access)

### `api_key_missing`

- **Ce que ça veut dire**: L’appel ne porte aucune clé d’API Azoth.
- **Cause la plus fréquente**: L’en-tête `Authorization` ou `X-Azoth-API-Key` manque, souvent parce qu’une variable d’environnement n’est pas définie.
- **Quoi faire**: Aucune clé API Azoth n’a été envoyée. Collez une clé issue de Réglages › Accès.
- **Qui peut le faire**: La personne qui développe le code appelant

### `api_key_scope_denied`

- **Ce que ça veut dire**: La clé est valide, mais elle est limitée — à des portées (les parties de l’API qu’elle peut appeler), à des connecteurs ou à des environnements — et cet appel sort de ces limites. À l’ingestion, le champ `dimension` de la réponse dit quelle limite l’a refusé : `connector` ou `environment`.
- **Cause la plus fréquente**: Une clé créée pour un usage, comme l’ingestion ou la lecture, a appelé une autre partie de l’API — ou a envoyé des événements d’un connecteur ou d’un environnement pour lesquels elle n’a pas été créée.
- **Quoi faire**: Cette clé API est limitée à certaines portées, certains connecteurs ou certains environnements, et cet appel en sort. Créez une clé qui le couvre, ou une clé sans ces limites (sans restriction).
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/settings?section=access)

### `api_key_name_taken`

- **Ce que ça veut dire**: Une clé active de l’espace porte déjà le nom demandé : deux clés actives d’un même espace ne partagent jamais un nom.
- **Cause la plus fréquente**: Une clé créée plus tôt sous ce nom et jamais révoquée — une clé expirée garde son nom tant qu’elle n’est pas révoquée.
- **Quoi faire**: Une clé active de cet espace porte déjà ce nom. Choisissez un autre nom, ou révoquez d’abord cette clé dans Réglages › Accès.
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/settings?section=access)

### `api_key_role_denied`

- **Ce que ça veut dire**: La clé est valide, mais son rôle — lecture, écriture ou administration — est inférieur à celui que cette route demande : une clé en lecture ne peut pas appeler une route qui écrit, et un export des réglages de l’espace demande une clé d’administration.
- **Cause la plus fréquente**: Une clé créée en lecture seule, utilisée par du code qui envoie des données ou fait des modifications — ou une clé d’un autre rôle que celui prévu pour l’intégration.
- **Quoi faire**: Le rôle de cette clé API n’autorise pas cet appel : une clé en lecture ne peut pas écrire, et certains exports demandent une clé d’administration. Créez une clé avec le rôle nécessaire dans Réglages › Accès.
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/settings?section=access)

### `ip_not_allowed`

- **Ce que ça veut dire**: La clé est valide, mais l’appel vient d’une adresse hors de la liste d’adresses IP autorisées de l’espace : l’espace n’accepte ses clés d’API que depuis les adresses qu’il liste.
- **Cause la plus fréquente**: Un nouveau serveur, une fonction cloud ou un réseau dont l’adresse de sortie n’est pas encore listée — ou un proxy qui change l’adresse d’où vient l’appel.
- **Quoi faire**: Cet appel vient d’une adresse hors de la liste d’adresses IP autorisées de l’espace. Appelez depuis une adresse listée, ou demandez à un propriétaire ou un administrateur d’ajouter celle-ci.
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail

### `on_behalf_of_not_allowed`

- **Ce que ça veut dire**: Cet appel a été bloqué : sa clé API ne peut pas nommer la personne pour qui il est fait.
- **Cause la plus fréquente**: Seule une clé de service qu’un owner ou un administrateur y a autorisée peut envoyer X-Azoth-On-Behalf-Of. Une clé personnelle parle toujours pour son propriétaire.
- **Quoi faire**: Envoyez l’appel sans cet en-tête, ou demandez à un owner ou à un administrateur une clé de service autorisée à nommer des personnes (Réglages › Accès).
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/settings?section=access)

### `human_identity_required`

- **Ce que ça veut dire**: Cet appel a été bloqué : il ne nomme pas la personne pour qui il est fait.
- **Cause la plus fréquente**: Cet espace de travail exige que chaque appel soit rattaché à une personne, pour que chaque décision montre qui l’a prise.
- **Quoi faire**: Utilisez votre clé API personnelle, ou envoyez X-Azoth-On-Behalf-Of (l’identifiant SCIM ou l’e-mail de la personne) avec une clé de service autorisée à nommer des personnes.
- **Qui peut le faire**: La personne qui développe le code appelant · [Ouvrir l’écran](https://www.azothos.ai/dashboard/settings?section=access)

### `identity_unavailable`

- **Ce que ça veut dire**: Cet appel a été bloqué : la personne pour qui il est fait n’a pas pu être vérifiée.
- **Cause la plus fréquente**: Azoth n’a pas pu lire la clé ou les règles d’attribution de l’espace de travail, et ne sert pas un appel qu’il ne peut pas attribuer quand l’attribution est exigée.
- **Quoi faire**: Réessayez dans un instant.
- **Qui peut le faire**: Azoth, ou l’opérateur de ce déploiement

### `invalid_on_behalf_of`

- **Ce que ça veut dire**: L’en-tête `X-Azoth-On-Behalf-Of` n’est pas un identifiant de personne qu’Azoth sait lire.
- **Cause la plus fréquente**: L’en-tête est vide, dépasse 256 caractères ou contient des caractères hors de l’ASCII visible.
- **Quoi faire**: X-Azoth-On-Behalf-Of doit compter de 1 à 256 caractères ASCII visibles : envoyez l’identifiant SCIM ou l’e-mail de la personne.
- **Qui peut le faire**: La personne qui développe le code appelant

### `key_not_bound_to_agent`

- **Ce que ça veut dire**: La passerelle MCP ne répond qu’à une clé d’API rattachée à un agent — celui dont le mandat décide de ce qu’elle peut appeler — et cette clé n’est rattachée à aucun.
- **Cause la plus fréquente**: Une clé de l’espace utilisée à la place de la clé créée pour un agent dans l’onglet Outils MCP, ou une clé d’agent détachée depuis.
- **Quoi faire**: Cette clé d’API n’est rattachée à aucun agent. Créez une clé pour l’agent dans l’onglet Outils MCP des Mandats, et donnez cette clé au client MCP.
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/mandats?tab=mcp)

### `invalid_key_identity`

- **Ce que ça veut dire**: Une clé personnelle parle toujours pour son propriétaire : elle ne peut pas nommer d’autres personnes.
- **Cause la plus fréquente**: Une clé personnelle créée avec l’option de nommer des personnes activée.
- **Quoi faire**: Pour nommer des personnes, créez une clé de service avec cette option ; une clé personnelle se crée sans elle.
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/settings?section=access)
