Démarrer gratuitement →

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.

Tous les codes d’erreur

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 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

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

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

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