Codes d’erreur
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.
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
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
AuthorizationouX-Azoth-API-Keymanque, 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
dimensionde la réponse dit quelle limite l’a refusé :connectorouenvironment. - 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
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
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
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
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
invalid_on_behalf_of
- Ce que ça veut dire
- L’en-tête
X-Azoth-On-Behalf-Ofn’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
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