verify_domain · Documentation d’Escouade Mail

Contrôle dans le DNS les enregistrements du domaine et rend l’état de chacun : trouvé, absent, ou valeur différente (avec la valeur vue).

En bref

Propriété	Valeur
Titre	Vérifier son domaine
Outil MCP	`verify_domain`, sur `https://api.subagent.fr/mcp`
Appelé par	l’assistant et la vue
Appel HTTP	`POST https://api.subagent.fr/v1/verify_domain`
Accès	permission `manage_inboxes`
État de l’espace	vérifié : sinon, refus `space_unverified`
Effet	écriture
Vue dans l’assistant	non

Ce que fait l’outil

Le serveur décrit l’outil ainsi à l’agent qui se branche :

Contrôle dans le DNS les enregistrements du domaine et rend l’état de chacun : trouvé, absent, ou valeur différente (avec la valeur vue). Le domaine est vérifié quand la preuve de propriété, les deux clés DKIM, le SPF et le MX sont bons ; DMARC est conseillé, non exigé. Un changement de DNS met parfois quelques minutes à se voir : corrigez, puis rappelez. Un domaine vérifié est recontrôlé chaque jour ; si ses enregistrements disparaissent, il est suspendu et ses boîtes n’envoient plus. Il est relevé de lui-même une fois le DNS revenu (recontrôle toutes les heures), ou tout de suite par verify_domain.

Paramètres

verify_domain accepte ces paramètres. Un paramètre inconnu est refusé avec le code invalid_argument.

Paramètre	Type	Obligatoire	Description
`domain`	texte	oui	Le domaine à contrôler (voir `list_domains`).

Résultat

L’outil rend un domaine. L’objet structuré déclare les champs ci-dessous ; la page de concept les décrit tous : voir les champs d’un domaine.

Champ	Type	Contenu
`domain`	texte	Nom de domaine.
`id`	texte	Identifiant du domaine (dom_…).
`last_checked_at`	texte ou `null`	La date du dernier contrôle DNS (ISO 8601), sinon `null`.
`records`	liste	Les enregistrements DNS à publier, et leur état au dernier contrôle. Chaque élément porte `label`, `name`, `note`, `required`, `role`, `seen`, `state`, `type`, `value`.
`status`	texte	pending : DNS à publier ; verified : on peut y créer des boîtes ; suspended : le DNS a disparu, ses boîtes n’envoient plus.
`status_reason`	texte ou `null`	La raison d’une suspension, sinon `null`.
`verified_at`	texte ou `null`	La date de la vérification (ISO 8601), sinon `null`.

Exemple d’appel

Les valeurs sont fictives.

HTTP

curl -X POST https://api.subagent.fr/v1/verify_domain \
  -H "Authorization: Bearer $SUBAGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "domain": "agents.exemple.fr"
}'

MCP · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "verify_domain",
    "arguments": {
      "domain": "agents.exemple.fr"
    }
  }
}

Refus possibles

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`.
`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`.
`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é.
`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.
`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.

S’y ajoutent les refus communs à tous les outils (unauthorized, forbidden, invalid_argument, rate_limited, internal) : voir Erreurs.

`verify_domain`