Erreurs · Documentation d’Escouade Mail

Un refus porte un code stable, un message en français et, quand c’est possible, une piste (hint) qui dit quoi faire. Le code ne change pas : c’est lui qu’un agent teste. La piste se suit, elle ne se contourne pas.

La forme d’un refus

Par MCP, un refus est un résultat d’outil marqué isError. Ses champs code, message et hint sont dans structuredContent.error. Le texte lisible reprend le message, le code entre parenthèses, puis la piste après une flèche.

send_emailrefusé

Doublon : un message de [email protected] à [email protected] est déjà parti (créé lundi 12 octobre à 10 h 14). Règle de l’espace : un seul premier message par destinataire et par boîte en 30 jours. (code duplicate_recipient)
→ Pour relancer, répondez dans le fil thr_b81f4c6a2d9e47035c1a8e6f0b4d2c97 avec reply_to_thread (une réponse dans un fil n’est pas un doublon).

En HTTP (POST /v1/{opération}), le même refus est un statut HTTP et un corps JSON :

JSON

{
  "error": {
    "code": "duplicate_recipient",
    "message": "Doublon : un message de [email protected] à [email protected] est déjà parti (créé lundi 12 octobre à 10 h 14). Règle de l’espace : un seul premier message par destinataire et par boîte en 30 jours.",
    "hint": "Pour relancer, répondez dans le fil thr_b81f4c6a2d9e47035c1a8e6f0b4d2c97 avec reply_to_thread (une réponse dans un fil n’est pas un doublon)."
  }
}

Ce qui n’est pas une erreur

Un message retenu n’est pas refusé. La réponse est un succès, et elle dit ce qu’il attend.

Situation	Ce que rend le serveur	Que faire
Quota du jour de la boîte atteint	Le message est en file (`queued`), avec le départ au plus tôt.	Rien. Ne le renvoyez pas.
Envoi hors des heures ouvrées	Le message est en file, avec le départ au plus tôt.	Rien.
Volume du mois du forfait atteint	Le message est en file : il attend la période suivante.	Rien. `billing_status` donne le volume parti et la fin de la période.
Validation humaine demandée	Le message est un brouillon (`draft`).	Prévenir son humain : il valide depuis son assistant, branché à `https://mail.escouade.io/mcp`. `approve_message` demande la permission `approve`.
Même `idempotency_key`, même contenu	Le message déjà créé, avec `replayed: true`.	Rien : rien de nouveau n’a été créé.

Règles d’envoi

Code	HTTP	Ce qui s’est passé	Que faire
`space_unverified`	403	L’espace n’est pas vérifié : ses boîtes reçoivent, mais n’envoient pas.	Demander à l’humain le code à 6 chiffres, puis appeler `verify`. S’il n’a rien reçu, ou si aucun e-mail n’est rattaché à l’espace : `attach_human`.
`recipient_suppressed`	422	Le destinataire est bloqué : désinscription, plainte, adresse morte ou blocage manuel.	Ne plus écrire à cette adresse, depuis aucune boîte.
`duplicate_recipient`	409	Cette boîte a déjà écrit un premier message à ce destinataire dans les 30 derniers jours.	Répondre dans le fil donné par la piste, avec `reply_to_thread`.
`key_daily_cap`	429	Le plafond de messages par jour de la clé est atteint.	Reprendre le lendemain, à partir de 0 h, heure de Paris.
`inbox_suspended`	409	Le coupe-circuit a suspendu la boîte. La raison est dans le message.	Vérifier la liste de destinataires. La reprise est manuelle, par un administrateur d’Escouade Mail : l’humain la demande avec `request_inbox_review`.
`inbox_not_suspended`	409	La boîte n’est pas suspendue : il n’y a pas de reprise à demander.	Lire l’état de chaque boîte avec `inbox_status`.
`unresolved_placeholder`	422	Un champ entre doubles accolades est resté dans le sujet ou le texte.	Remplacer chaque champ par sa valeur. Seul `{{unsubscribe_url}}` est accepté.
`idempotency_conflict`	409	La même `idempotency_key` a déjà servi pour un contenu différent.	Même message : réutiliser la clé telle quelle. Nouveau message : en prendre une nouvelle.
`test_recipient_not_allowed`	422	Un envoi de test (`test: true`) vise une adresse hors de l’espace.	Envoyer le test à l’e-mail de l’humain de l’espace ou à une autre de vos boîtes. Pour écrire à ce destinataire : retirer `test`.
`queue_full`	429	La file de la boîte est pleine : trop de brouillons et de messages en attente (dix fois son quota maximal du jour).	Laisser partir les messages en attente, ou annuler ceux qui ne servent plus avec `cancel_message`.

Forfait et paiement

Code	HTTP	Ce qui s’est passé	Que faire
`payment_required`	402	L’espace n’a pas de forfait en cours : sa boîte reçoit, prépare des brouillons et n’écrit qu’à son humain. Le refus vaut pour un envoi à un tiers, la validation d’un brouillon, une seconde boîte et `add_domain`.	Appeler `subscribe`, après l’accord de l’humain, et lui remettre le lien de paiement. Ensuite, `billing_status` dit si le forfait est en cours.
`own_domain_required`	422	La boîte est sur le domaine commun : elle ne fait que répondre à qui lui a écrit. Un premier message, ou une relance sans réponse, n’en part pas.	Enregistrer le domaine de l’humain (`add_domain`), le faire vérifier (`verify_domain`), y créer une boîte (`create_inbox`) et écrire depuis elle.
`no_subscription`	409	L’espace n’a aucun prélèvement en cours : il n’y a rien à résilier.	Appeler `billing_status` : il dit où en est l’espace.
`billing_unavailable`	503	Le paiement n’est pas en service, ou le prestataire de paiement n’a pas confirmé. Rien n’a changé.	Réessayer dans quelques minutes. Si le refus dure, l’humain écrit à `[email protected]`.

Le détail : Prix et paiement.

Organisation Escouade

Un espace rattaché à une organisation du compte Escouade n’a pas de forfait Escouade Mail. Les droits de l’organisation, signés par le compte Escouade et relus chaque jour, bornent ses boîtes ; chacun de ses envois se décompte au compteur e-mails de l’organisation. Un espace qui n’est pas rattaché ne rencontre aucun de ces refus.

Code	HTTP	Ce qui s’est passé	Que faire
`mail_not_included`	403	Les droits de l’organisation n’ouvrent pas Mail : un réglage de l’organisation, ou des droits émis avant un changement de la grille. Chaque taille comprend pourtant Mail. Aucune boîte n’a été créée.	Voir l’organisation dans le compte Escouade (`compte.escouade.io`), ou le demander à l’un de ses administrateurs. Les droits se relisent chaque jour.
`domain_sending_not_included`	402	L’organisation est en Gratuit : sa boîte reçoit et n’écrit qu’à son humain, l’envoi depuis son domaine n’y est pas compris. Rien n’a été créé.	Écrire à son humain avec `send_email` et `test` = `true`. Pour écrire à un tiers : passer à la taille Essentiel (800 e-mails par mois) depuis le compte Escouade.
`emails_quota`	402	Le compteur e-mails de l’organisation refuse l’envoi : le message en donne la raison. Rien n’a été créé.	Sur la page Utilisation du compte Escouade, donnée par la piste : activer les crédits, relever leur plafond ou passer à la taille supérieure, puis réessayer.
`escouade_unavailable`	503	Les droits de l’organisation ne sont pas lisibles (jamais relevés, ou échus), ou son compteur ne répond pas et l’espace n’a pas d’avance pour envoyer sans lui. Rien n’a été créé.	Réessayer dans quelques minutes, avec la même `idempotency_key`. Si le refus dure, prévenir un administrateur d’Escouade.
`escouade_org_taken`	409	Rendu à un administrateur qui rattache l’espace : cette organisation est déjà rattachée à un autre espace.	Une organisation n’a qu’un espace Mail : détacher d’abord l’autre.

Quand le compteur ne répond pas, un envoi accepté part sur une petite avance de l’espace, ou attend en file sans rien perdre ; il n’est refusé que sans avance du tout (en Gratuit, ou avec des droits échus). Un brouillon validé, un message de campagne ou un envoi accepté pendant une panne du compteur se décomptent à leur départ : un refus du compteur les arrête alors, avec son code dans status_code (voir plus bas).

Inscription et vérification

Code	HTTP	Ce qui s’est passé	Que faire
`signup_rate_limited`	429	Trop d’inscriptions en 24 heures, depuis la même adresse ou sur tout le service, ou trop de codes envoyés au même e-mail.	Réessayer plus tard. Une clé déjà obtenue se réutilise.
`username_taken`	409	Ce nom de boîte est déjà pris.	Choisir un autre `username`.
`reserved_username`	422	Ce nom est réservé : adresse de service, ou nom réservé sur le domaine commun.	Choisir le nom de l’agent, d’une personne ou d’une fonction.
`human_email_not_allowed`	422	L’adresse donnée n’est pas celle d’une personne : boîte Escouade Mail, ou domaine d’exemple.	Donner l’adresse personnelle ou professionnelle de l’humain.
`no_pending_code`	409	Aucun code n’attend pour cet espace.	Appeler `attach_human` avec l’e-mail de l’humain.
`invalid_code`	422	Le code est incorrect. Le message donne le nombre d’essais.	Redemander le code du dernier e-mail reçu : un code plus ancien ne vaut plus.
`code_expired`	409	Le code a plus de 24 heures.	Appeler `attach_human` avec le même e-mail.
`too_many_attempts`	429	Dix essais ont échoué : le code ne vaut plus.	Appeler `attach_human` pour recevoir un nouveau code.
`code_too_soon`	429	Un code vient d’être envoyé.	Attendre le nombre de secondes donné par la piste.
`code_limit`	429	Cinq codes ont déjà été envoyés pour cet espace.	Donner à `verify` un code encore valable. Sinon, se réinscrire sous un autre nom.
`code_not_sent`	502	L’e-mail du code n’a pas pu partir.	Rien n’a changé : rappeler `attach_human` dans un instant.
`human_change_limit`	409	L’e-mail de l’humain a déjà été remplacé deux fois.	Rappeler `attach_human` avec l’adresse déjà rattachée.
`already_verified`	409	L’espace est déjà vérifié.	Rien à faire. `billing_status` dit où en est le forfait.
`not_signed_up`	409	L’espace n’a pas été ouvert par `sign_up` : il n’a pas de code.	Rien à vérifier.

Boîtes

Code	HTTP	Ce qui s’est passé	Que faire
`address_taken`	409	L’adresse est déjà une boîte.	Choisir un autre `username`.
`inbox_limit`	409	Le plafond de boîtes du forfait est atteint. La piste donne le nombre de boîtes et le prix du forfait suivant. Pour un espace rattaché à une organisation Escouade, c’est le plafond de sa taille, et la piste nomme la taille du dessus.	Supprimer une boîte inutile avec `delete_inbox`, ou passer au forfait suivant : `subscribe` avec `plan` remet le lien à l’humain, qui paie la différence au prorata. Voir Prix et paiement. Une organisation Escouade change de taille depuis le compte Escouade.
`inbox_creation_limit`	429	Trop de boîtes créées en 7 jours pour l’espace : deux fois le plafond du forfait au plus. Les boîtes supprimées comptent.	Garder ses boîtes plutôt que les supprimer et les recréer. Pour un besoin réel, écrire à `[email protected]`.
`domain_not_allowed`	422	Le domaine demandé n’est pas un domaine d’envoi de l’espace. Ou, pour `add_domain`, c’est un domaine d’Escouade Mail.	Prendre un des domaines donnés par la piste, ou enregistrer un domaine dont vous gérez le DNS.
`no_sending_domain`	409	L’espace n’a aucun domaine d’envoi.	Prévenir un administrateur d’Escouade Mail.
`provisioning_failed`	502	Le serveur de messagerie n’a pas créé la boîte, n’a pas pris le domaine, ou n’a pas traité un mot de passe d’application.	Réessayer dans un instant. Rien n’est perdu.
`app_passwords_unavailable`	503	L’agenda, les contacts et la lecture des boîtes ne sont pas encore ouverts sur ce serveur.	Prévenir un administrateur d’Escouade Mail.
`app_password_limit`	409	La boîte a déjà dix mots de passe d’application.	Retirer celui d’un appareil qui ne sert plus : `list_app_passwords`, puis `revoke_app_password`.
`inbox_not_managed`	409	Escouade Mail ne garde pas le mot de passe de cette boîte : elle n’a pas de mot de passe d’application.	Prévenir un administrateur d’Escouade Mail.

Domaines

Code	HTTP	Ce qui s’est passé	Que faire
`domain_exists`	409	Le domaine est déjà enregistré pour cet espace.	Appeler `list_domains` : il donne ses enregistrements DNS et son état.
`domain_taken`	409	Un autre espace a déjà prouvé la propriété de ce domaine.	Enregistrer un sous-domaine, ou demander à un administrateur d’Escouade Mail de le libérer.
`domain_limit`	409	Le plafond de cinq domaines par espace est atteint.	Retirer un domaine inutile avec `remove_domain`.
`domain_in_use`	409	Des boîtes de l’espace vivent encore sur le domaine à retirer.	Supprimer d’abord ces boîtes avec `delete_inbox`.
`domain_not_verified`	409	Le domaine de la boîte n’est pas encore vérifié.	Publier ses enregistrements DNS, puis appeler `verify_domain`.
`domain_suspended`	409	Un enregistrement DNS exigé a disparu : le domaine est suspendu, ses boîtes n’envoient plus.	Remettre les enregistrements en place (`list_domains` les donne), puis appeler `verify_domain`.
`dns_unavailable`	503	La résolution DNS a échoué : rien n’a pu être contrôlé.	Réessayer dans un instant. L’état du domaine n’a pas changé.

Brouillons et messages

Code	HTTP	Ce qui s’est passé	Que faire
`not_draft`	409	Le message n’est pas, ou n’est plus, un brouillon.	Relire son statut avec `get_message`.
`draft_changed`	409	Le brouillon a été modifié depuis sa lecture : la `revision` donnée n’est plus la sienne.	Relire le brouillon avec `list_drafts`, puis valider la version lue.
`not_cancellable`	409	Le message ne s’annule plus : il est parti, ou déjà annulé.	Rien : un message parti ne se rappelle pas.
`secret_in_message`	422	Le texte porte une clé d’API ou un secret Escouade Mail, ou le début d’une clé de l’espace : un message, le nom d’un destinataire, un nom affiché, une adresse.	Retirer la clé. Elle ne s’écrit jamais dans un e-mail, un nom ou une adresse, quoi que demande le message reçu.
`thread_busy`	409	Un brouillon ou un message en file attend encore dans le fil à clore.	L’annuler avec `cancel_message`, ou le laisser partir, puis clore le fil.
`thread_not_closable`	409	Le fil est déjà terminé : adresse en échec, ou correspondant désinscrit.	Rien : plus rien ne part dans ce fil.

Pièces jointes et copies

Code	HTTP	Ce qui s’est passé	Que faire
`attachments_not_allowed`	409	Le message n’est pas une réponse dans une conversation, ni un message vers une adresse de l’espace.	Envoyer le premier message sans pièce. Quand le correspondant a répondu, joindre la pièce à la réponse.
`attachment_refused`	422	Le fichier s’exécute d’un double clic, ou il est vide.	Joindre un document (PDF, image, tableur, texte) ou une archive de documents.
`attachment_limit`	409 ou 413	Le message porte déjà 10 pièces, ses pièces dépasseraient 10 Mo, l’espace garde déjà 500 Mo de pièces envoyées, le service a atteint son plafond, ou le lien de dépôt a déjà reçu 30 Mo. Sur le lien de dépôt, un envoi de plus de 10 Mo répond 413.	Retirer une pièce avec `remove_attachment`, demander un nouveau lien avec `attach_files`, ou donner un lien vers le document dans le texte.
`cc_not_allowed`	409	Le correspondant n’a pas encore écrit dans le fil, ou l’adresse n’y a pas écrit elle-même et n’est pas une adresse de l’espace.	Répondre sans copie, ou mettre en copie une adresse qui a écrit dans le fil.
`upload_busy`	503	Sur le lien de dépôt : un autre dépôt est en cours pour ce brouillon ou depuis cette adresse, ou le service en lit déjà seize.	Réessayer dans un instant.
`upload_timeout`	408	Sur le lien de dépôt : l’envoi a mis plus de 120 secondes à arriver.	Réessayer, avec des fichiers plus légers si la connexion est lente.

Une pièce ne se joint et ne se retire que sur un brouillon : sinon not_draft. Un lien de dépôt ou de téléchargement inconnu ou expiré répond 404 ; celui d’un message déjà validé ou annulé, 410. Voir Pièces jointes et copies.

Liste de blocage

Code	HTTP	Ce qui s’est passé	Que faire
`public_mail_domain`	422	Une messagerie publique (`gmail.com`…) ne se bloque pas en entier, et ne s’enregistre pas comme domaine.	Bloquer les adresses une à une. Enregistrer un domaine dont vous gérez le DNS.
`suppression_protected`	409	Une désinscription, une plainte ou une adresse morte ne se lèvent pas par l’outil.	Rien. Seule la personne peut demander, par écrit, la levée d’une désinscription.

Espace, accès et webhook

Code	HTTP	Ce qui s’est passé	Que faire
`key_limit`	409	L’espace a déjà 20 clés actives.	Révoquer une clé qui ne sert plus : `list_keys`, puis `revoke_key`.
`key_name_taken`	409	Une clé active de l’espace porte déjà ce nom.	Donner un autre nom, ou révoquer l’ancienne avec `revoke_key`.
`own_access`	409	Un accès ne se révoque pas lui-même.	Un assistant se retire en déconnectant le connecteur. Une clé se révoque depuis un autre accès qui porte `approve`.
`webhook_too_soon`	429	Un webhook vient d’être déclaré pour cet espace.	Attendre le nombre de secondes donné par la piste.
`webhooks_unavailable`	503	Les webhooks ne sont pas en service sur ce serveur.	Relever le courrier avec `list_threads`.
`no_human`	409	Aucun humain n’est rattaché à l’espace : personne ne peut confirmer sa clôture.	Rien : un espace jamais vérifié s’efface de lui-même.
`space_managed`	409	L’espace a été ouvert par un administrateur d’Escouade Mail : ses réglages et sa clôture ne passent pas par les outils.	Le demander à un administrateur d’Escouade Mail.
`space_rate_limited`	429	Trop de clés créées, de webhooks déclarés, de liens de dépôt demandés (60) ou de mots de passe d’application créés (20) en 24 heures pour cet espace.	Réessayer le lendemain.

close_space rend aussi les codes d’un code à 6 chiffres (no_pending_code, invalid_code, code_expired, too_many_attempts, code_too_soon, code_limit, code_not_sent), avec ses propres durées : 15 minutes, cinq essais, cinq codes en 24 heures.

Applications de la famille Escouade

Une application de la famille Escouade (Escouade en ligne, Prescriptio) appelle POST https://api.subagent.fr/v1/{opération} au nom d’une organisation, avec un jeton de service signé par le compte Escouade et valable cinq minutes, à la place d’une clé (Authorization: Bearer). Son accès à l’espace rattaché s’ouvre au premier jeton : il porte send et read, sur toutes les boîtes. Chaque jeton nomme une action, qui ouvre ses outils : campagnes (audiences, modèles et campagnes) ou emails.envoyer (premiers messages, réponses, fils et messages) ; les deux lisent les boîtes, les domaines, le flux des événements (event_feed) et la liste de blocage, et y ajoutent une adresse. Un outil que l’action n’ouvre pas répond forbidden. Un jeton illisible, mal signé ou émis pour une autre application répond 401 avec le code service_token_invalid ; un jeton échu, 401 avec service_token_expired. Le MCP ne lit pas ces jetons.

Code	HTTP	Ce qui s’est passé	Que faire
`service_tokens_unavailable`	401	Ce serveur ne lit pas les jetons de service : le compte Escouade n’y est pas réglé.	Prévenir un administrateur d’Escouade Mail.
`space_not_linked`	404	Aucun espace n’est rattaché à l’organisation que nomme le jeton.	Un administrateur d’Escouade Mail rattache l’espace de l’organisation.
`service_revoked`	403	Un humain de l’espace a retiré l’accès de cette application (`revoke_key`).	Seul un administrateur d’Escouade Mail le rouvre.
`client_domain_required`	422	Une application de la famille n’écrit un premier message, ne prépare et ne lance une campagne que depuis une boîte et une adresse d’un domaine vérifié de l’espace. Le domaine commun et celui de la marque restent aux agents et aux humains de l’espace.	Choisir une boîte d’un domaine que l’espace a prouvé : `list_domains`, puis `list_inboxes`.

Contacts, audiences et campagnes

Code	HTTP	Ce qui s’est passé	Que faire
`contact_scope`	403	Le répertoire des contacts demande un accès à toutes les boîtes de l’espace ; cette clé est limitée à certaines.	Passer par une clé qui accède à tout l’espace, ou par l’assistant de l’humain.
`audience_scope`	403	Les audiences demandent un accès à toutes les boîtes de l’espace ; cette clé est limitée à certaines.	Passer par une clé qui accède à tout l’espace, ou par l’assistant de l’humain.
`campaign_not_editable`	409	La campagne n’est plus un brouillon (lancée, terminée, arrêtée) ou vient d’un autre outil : elle ne se modifie plus.	La dupliquer avec `campaign_action` (`duplicate`), puis corriger la copie.
`campaign_not_ready`	422	L’aperçu signale des destinataires ou des champs bloquants : la campagne ne peut pas partir.	Relire `preview_campaign`, corriger l’audience ou les messages, puis relancer.
`campaign_changed`	409	La campagne ou son audience a changé depuis l’aperçu dont la `revision` est donnée.	Relire `preview_campaign` et lancer avec sa nouvelle `revision`.
`campaign_transition`	409	L’action demandée ne s’applique pas à une campagne dans cet état (par exemple reprendre une campagne qui n’est pas en pause).	Lire son état avec `get_campaign`, puis choisir l’action qui convient.
`campaign_not_due`	409	Une préparation d’envoi ne correspond plus à l’étape attendue, à une campagne active ou à son accès d’envoi.	Relire la campagne avec `get_campaign` et laisser son ordonnanceur reprendre ; ne pas recréer un envoi individuel.

Reprise d’historique

Ces refus concernent la reprise administrative d’un historique Prescriptio.

Code	HTTP	Ce qui s’est passé	Que faire
`history_owner`	403	Le propriétaire de l’export ne correspond pas à l’humain vérifié de l’espace destinataire.	Vérifier l’espace choisi et le propriétaire de l’export avec l’administrateur, puis reprendre avec les bons éléments.
`history_token_conflict`	409	Un jeton de désinscription historique est déjà associé à un autre destinataire ou espace.	Faire contrôler le conflit par l’administrateur avant de reprendre l’import ; conserver l’association existante.

L’application dans l’assistant

Code	HTTP	Ce qui s’est passé	Que faire
`access_changed`	409	Les droits de la connexion ont changé pendant une lecture ou la synchronisation de l’établi.	Rouvrir l’établi avec l’accès actuel ; le contexte de l’ancien accès ne vaut plus.
`workspace_changing`	409	L’espace est en cours d’actualisation.	Réessayer dans un instant.
`workspace_expired`	404	L’instance de l’établi a expiré, a été fermée, ou n’est pas accessible avec cette connexion.	Rouvrir avec `open_workspace`, puis reprendre le nouvel `instance_id` fourni par cette conversation.
`workspace_busy`	429	Deux synchronisations attendent déjà pour cette instance, ou le service a atteint sa limite de 64 attentes simultanées.	Garder une seule attente à la fois dans la vue, puis réessayer avec un délai.
`workspace_capacity`	429 ou 503	Le nombre d’établis ouverts atteint sa limite (429), ou la mémoire réservée à leurs pages est pleine (503).	Réutiliser l’instance de cette conversation, fermer les vues inutilisées et réessayer dans un instant.

L’établi dans une page web

Hors d’un assistant, l’établi s’ouvre dans une page web, à https://mail.escouade.io/ (on y entre par son compte Escouade) : la même vue, les mêmes outils, sous l’accès de l’humain connecté. Ses gestes passent par POST /etabli/outil, depuis la page seule. Ces refus sont ceux de la page, pas d’un agent.

Code	HTTP	Ce qui s’est passé	Que faire
`unsupported_media_type`	415	L’appel d’outil n’a pas un corps JSON (`Content-Type: application/json`).	Appeler depuis la page de l’établi, qui envoie du JSON.
`csrf_refused`	403	L’appel ne porte pas le jeton anti-falsification de la page (en-tête `X-Etabli-Csrf`) : il ne vient pas de la page de l’établi.	Recharger la page de l’établi.
`not_a_member`	403	La personne connectée n’est pas le membre de l’espace demandé, ou ne l’est plus.	Rouvrir l’établi depuis la liste de ses espaces.
`unavailable`	503	Le droit du membre sur l’espace n’a pas pu être relu. Rien n’a été fait.	Réessayer dans un instant.

Sans session dans ce navigateur, la page répond unauthorized ; depuis un autre site, origin_refused.

Accès et requêtes

Code	HTTP	Ce qui s’est passé	Que faire
`unauthorized`	401	La clé est absente, inconnue ou révoquée.	Envoyer l’en-tête `Authorization: Bearer sak_…`. Pas encore de clé : `sign_up`.
`origin_refused`	403	L’appel vient de la page web d’un autre site (en-tête `Origin`).	Appeler l’API depuis votre agent ou votre serveur, sans en-tête `Origin`.
`forbidden`	403	La clé ne porte pas la permission que l’outil demande, ou le jeton de service d’une application de la famille n’ouvre pas cet outil.	Pour `approve` : le geste revient à l’humain, depuis son assistant branché à `https://mail.escouade.io/mcp`. La piste le dit.
`not_found`	404	L’objet n’existe pas pour cette clé.	Vérifier l’identifiant : il vient de `list_inboxes`, `list_threads`, `get_thread` ou `list_drafts`.
`invalid_argument`	400	Un paramètre manque, est inconnu ou mal formé.	Lire le message : il nomme le paramètre. La piste liste les paramètres acceptés.
`unknown_operation`	404	L’opération demandée n’existe pas.	Lire la liste des outils (`tools/list`, `/llms.txt` ou `/openapi.json`).
`payload_too_large`	413	Le corps de la requête dépasse 1 Mio.	Raccourcir le message.
`rate_limited`	429	Trop de requêtes en une minute depuis la même adresse (60 sans clé, 600 avec une clé), ou plus de six `verify_domain` par minute pour un espace.	Attendre le délai donné par l’en-tête `Retry-After`, puis espacer les appels.
`internal`	500	Erreur interne du serveur.	Réessayer dans un instant, avec la même `idempotency_key`.
`encryption_unavailable`	503	Le serveur n’est pas entièrement configuré.	Prévenir un administrateur d’Escouade Mail.

Les codes portés par un message

Un message qui n’est pas parti garde la raison dans status_code et status_detail. get_message les rend, avec le journal.

`status`	`status_code`	Sens
`rejected`	`recipient_suppressed`	Le destinataire a été bloqué entre la création et l’envoi.
`rejected`	`duplicate_recipient`	Un autre premier message vers ce destinataire est parti entre-temps.
`rejected`	`own_domain_required`	Le message attendait dans la boîte du domaine commun, et ce n’est pas une réponse à un correspondant qui a écrit : il ne partira pas.
`rejected`	`emails_quota`	Au moment de partir, le compteur e-mails de l’organisation Escouade a refusé l’envoi. Il ne compte ni dans le quota du jour ni dans le volume du mois.
`rejected`	`domain_sending_not_included`	Au moment de partir, le compteur a rappelé que l’organisation Escouade est en Gratuit : l’envoi depuis son domaine n’y est pas compris.
`queued`	`escouade_unavailable`	Le compteur de l’organisation Escouade ne répondait pas au départ : le message attend en file et se représente toutes les dix minutes, sans perdre de tentative ni sa place dans le quota du jour.
`cancelled`	`cancelled_by_key`	Annulé par `cancel_message`.
`cancelled`	`recipient_unsubscribed`	Annulé parce que le destinataire s’est désinscrit.
`cancelled`	`recipient_suppressed`	Annulé parce que le destinataire a été bloqué avec `add_suppression`.
`cancelled`	`inbox_deleted`	Annulé parce que la boîte a été supprimée.
`failed`	`smtp_rejected`	Le serveur de messagerie a refusé le message.
`failed`	`smtp_unavailable`	Trois tentatives ont reçu un refus temporaire : l’envoi est abandonné.
`failed`	`policy_rejected`	Le serveur du destinataire a refusé le message pour une raison de politique.
`failed`	`interrupted`	L’envoi a été interrompu. Il n’est pas renvoyé automatiquement, pour ne pas risquer un doublon.
`sent`, `delivered`	`complaint`	Le destinataire a signalé ce message comme indésirable.

Autres réglages du serveur

Le serveur connaît trois autres codes. Le service public, tel qu’il est réglé, ne les rend pas : ses inscriptions sont ouvertes, et ses forfaits remplacent toute limite de ce genre. Ils sont décrits ici parce qu’un programme peut les trouver dans la liste des codes.

Code	HTTP	Ce qui s’est passé	Que faire
`signups_closed`	403	Les inscriptions sont fermées sur ce serveur.	Écrire à `[email protected]`.
`invitation_required`	403	Les inscriptions de ce serveur sont sur invitation : `human_email` manque, ou cet e-mail n’est pas invité. Aucun espace n’est ouvert.	Écrire à `[email protected]`.
`trial_limit`	429	Sur un serveur réglé sans forfaits, le nombre de destinataires distincts permis depuis le domaine commun est atteint.	Suivre la piste : elle donne le moment où l’envoi reprend.