# Toute requête : validation et pannes du serveur

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)

### `validation_failed`

- **Ce que ça veut dire**: Le corps ou les paramètres de la requête ne correspondent pas à ce que la route accepte : rien n’a été fait. Le champ `error` de la réponse décrit le problème et `field` nomme le champ, quand il y en a un.
- **Cause la plus fréquente**: Un champ obligatoire manquant, une valeur du mauvais type ou hors de ses bornes, ou une option inconnue — souvent un client écrit pour une version plus ancienne de l’API.
- **Quoi faire**: Une valeur envoyée n’est pas acceptée. Corrigez le champ indiqué, puis renvoyez la demande.
- **Qui peut le faire**: La personne qui développe le code appelant

### `internal_error`

- **Ce que ça veut dire**: La requête a échoué du côté d’Azoth, pour une raison que la réponse ne donne pas : rien dans la requête n’était en cause. L’échec est enregistré pour l’équipe d’Azoth.
- **Cause la plus fréquente**: Un bref problème de base de données ou de réseau, ou un bug.
- **Quoi faire**: Une erreur s’est produite du côté d’Azoth. Réessayez dans un instant ; si elle se répète, contactez le support.
- **Qui peut le faire**: Azoth, ou l’opérateur de ce déploiement

### `not_found`

- **Ce que ça veut dire**: Rien de ce que la requête désigne n’existe dans cet espace — ou cela existe, mais cet appelant ne peut pas le lire.
- **Cause la plus fréquente**: Un identifiant saisi à la main ou pris dans un autre espace, un élément supprimé depuis, ou une demande faite par une autre clé d’API.
- **Quoi faire**: Rien n’a été trouvé avec cet identifiant dans cet espace : il a peut-être été supprimé, ou appartient à un autre espace. Rechargez, ou vérifiez l’identifiant.
- **Qui peut le faire**: Tout membre de l’espace de travail

### `service_unavailable`

- **Ce que ça veut dire**: Azoth n’a pas pu joindre sa base de données : rien n’a été fait, rien n’a été enregistré.
- **Cause la plus fréquente**: Sur le service d’Azoth, une brève panne. Sur un déploiement à vous, sa connexion à la base de données n’est pas configurée.
- **Quoi faire**: Le service est indisponible pour le moment, et rien n’a été fait. Réessayez dans un instant ; si cela persiste, contactez le support ou l’opérateur de ce déploiement.
- **Qui peut le faire**: Azoth, ou l’opérateur de ce déploiement

### `unknown_tool`

- **Ce que ça veut dire**: Aucun outil de l’assistant ne porte ce nom. Le champ `tools` de la réponse liste les noms qui existent.
- **Cause la plus fréquente**: Un nom mal saisi, ou un ancien nom dont la période de transition est terminée.
- **Quoi faire**: Aucun outil ne porte ce nom : utilisez l’un des noms que la réponse liste sous tools.
- **Qui peut le faire**: La personne qui développe le code appelant

### `not_configured`

- **Ce que ça veut dire**: Il manque à ce déploiement un réglage dont la requête a besoin (un secret, le compte ou les clés d’un fournisseur) : rien n’a été fait. Réessayer n’y change rien tant qu’il n’est pas défini.
- **Cause la plus fréquente**: Sur le service d’Azoth, une erreur de configuration que l’équipe d’Azoth corrige. Sur un déploiement à vous, un réglage que son opérateur n’a pas défini ; le journal du serveur le nomme.
- **Quoi faire**: Cette fonction n’est pas configurée sur ce déploiement, et rien n’a été fait. Contactez le support ou l’opérateur de ce déploiement : il manque un réglage dont elle a besoin.
- **Qui peut le faire**: Azoth, ou l’opérateur de ce déploiement

### `migration_missing`

- **Ce que ça veut dire**: Cette fonction a besoin d’une mise à jour de la base de données qui n’est pas encore appliquée : rien n’a été fait.
- **Cause la plus fréquente**: Sur le service d’Azoth, une mise à jour pas encore appliquée. Sur un déploiement qui vous est propre, son opérateur n’a pas appliqué les dernières mises à jour de la base de données.
- **Quoi faire**: Cette fonction attend une mise à jour de la base de données qui n’a pas encore été appliquée, et rien n’a été fait. Contactez le support ou l’opérateur de ce déploiement.
- **Qui peut le faire**: Azoth, ou l’opérateur de ce déploiement

### `replay_unavailable`

- **Ce que ça veut dire**: Azoth ne peut pas renvoyer une requête : Azoth garde une empreinte de chaque prompt, jamais le prompt lui-même.
- **Cause la plus fréquente**: Une trace enregistrée qu’on demande de relancer.
- **Quoi faire**: Renvoyez la requête depuis votre propre code ; pour comparer des modèles, utilisez un jeu de référence.
- **Qui peut le faire**: La personne qui développe le code appelant

### `action_not_offered`

- **Ce que ça veut dire**: Cette action n’est pas proposée pour cet élément de la file.
- **Cause la plus fréquente**: Un écran qui montrait un état plus ancien de l’élément.
- **Quoi faire**: Rechargez la file, puis choisissez l’une des actions qu’elle propose.
- **Qui peut le faire**: Tout membre de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/accueil)

### `item_not_waiting`

- **Ce que ça veut dire**: Cet élément n’attend plus dans la file.
- **Cause la plus fréquente**: Quelqu’un a agi dessus, ou ce qu’il attendait a été réglé.
- **Quoi faire**: Rechargez la file.
- **Qui peut le faire**: Tout membre de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/accueil)

### `not_allowed`

- **Ce que ça veut dire**: Vous ne pouvez pas agir sur cet élément de la file.
- **Cause la plus fréquente**: Un élément qui attend une autre personne, ou que vous avez vous-même demandé (quatre yeux).
- **Quoi faire**: Laissez-le à la personne qu’il attend, ou à un propriétaire ou un administrateur.
- **Qui peut le faire**: Tout membre de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/accueil)

### `delegate_to_self`

- **Ce que ça veut dire**: Un élément ne se délègue pas à soi-même.
- **Cause la plus fréquente**: Votre propre nom choisi dans la liste.
- **Quoi faire**: Choisissez un autre membre.
- **Qui peut le faire**: Tout membre de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/accueil)

### `delegate_not_allowed`

- **Ce que ça veut dire**: Le membre choisi ne peut pas agir sur cet élément : il ne peut pas lui être délégué.
- **Cause la plus fréquente**: Un membre sans le rôle requis, ou la personne qui l’a demandé.
- **Quoi faire**: Choisissez un propriétaire, un administrateur, ou le membre que nomme l’élément.
- **Qui peut le faire**: Tout membre de l’espace de travail · [Ouvrir l’écran](https://www.azothos.ai/dashboard/accueil)

### `worker_secret_invalid`

- **Ce que ça veut dire**: Une tâche planifiée ou une route interne du déploiement a été appelée sans son secret : rien n’a été exécuté.
- **Cause la plus fréquente**: Un appel qui ne vient ni du planificateur du déploiement ni de ses propres outils, ou un planificateur réglé avec un autre secret que celui du serveur.
- **Quoi faire**: Cette route n’est appelée que par le planificateur du déploiement, avec son secret. Si vous exploitez ce déploiement, donnez au planificateur le même secret que le serveur.
- **Qui peut le faire**: Azoth, ou l’opérateur de ce déploiement

### `already_exists`

- **Ce que ça veut dire**: Ce que la requête ajouterait existe déjà : le nom, l’adresse ou la valeur donnés sont pris, rien n’a été ajouté.
- **Cause la plus fréquente**: Le même formulaire envoyé deux fois, ou un nom ou une valeur qu’un autre élément de l’espace utilise.
- **Quoi faire**: Un élément avec ce nom ou cette valeur existe déjà : rien n’a été ajouté. Choisissez-en un autre, ou utilisez celui qui existe.
- **Qui peut le faire**: Tout membre de l’espace de travail

### `operation_in_progress`

- **Ce que ça veut dire**: La même opération est déjà en cours pour cet espace : cette requête n’a rien fait.
- **Cause la plus fréquente**: Un double clic, ou deux personnes ou processus qui la lancent au même moment.
- **Quoi faire**: C’est déjà en cours pour cet espace. Attendez une minute, rechargez, puis réessayez si c’est encore nécessaire.
- **Qui peut le faire**: Tout membre de l’espace de travail

### `method_not_allowed`

- **Ce que ça veut dire**: La route n’accepte pas cette méthode HTTP ; l’en-tête `Allow` de la réponse nomme celle qu’elle accepte.
- **Cause la plus fréquente**: Un lien ou un script qui envoie GET à une route qui attend POST — la déconnexion, par exemple, ne se fait jamais depuis un lien.
- **Quoi faire**: Cette action ne se fait pas depuis un lien. Utilisez son bouton dans l’application, ou envoyez la méthode que la route accepte.
- **Qui peut le faire**: La personne qui développe le code appelant

### `integration_not_connected`

- **Ce que ça veut dire**: L’intégration dont cette action a besoin — GitHub, Slack, Microsoft Teams, l’authentification unique ou un point d’accès de modèle — n’est pas configurée pour cet espace.
- **Cause la plus fréquente**: Elle n’a jamais été connectée, ou elle a été retirée depuis.
- **Quoi faire**: Cette intégration n’est pas encore configurée pour cet espace. Un propriétaire ou un administrateur la configure dans Réglages, puis réessayez.
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail

### `integration_failed`

- **Ce que ça veut dire**: Le service d’une intégration — GitHub, Slack, Microsoft Teams — a refusé ou n’a pas traité la requête qu’Azoth lui a envoyée : rien n’a été fait. La réponse donne son statut HTTP (`vendorStatus`) et son propre code d’erreur (`vendorCode`), jamais son texte.
- **Cause la plus fréquente**: Son application a été désinstallée ou a perdu une permission, l’élément demandé n’y existe plus, ou le service est en panne.
- **Quoi faire**: Le service de l’intégration a refusé la requête. Vérifiez que son application est toujours installée avec ses permissions, puis réessayez plus tard.
- **Qui peut le faire**: Un propriétaire ou un admin de l’espace de travail
