`email_status`

Récupérer l'état de livraison d'un message précédemment envoyé.

Catégorie: Email
Stabilité: Bêta
Version: v1
Auth: cf-access

Schéma d’entrée

{
  "type": "object",
  "properties": {
    "message_id": { "type": "string" }
  },
  "required": ["message_id"]
}

Schéma de sortie

{
  "type": "object",
  "properties": {
    "message_id": { "type": "string" },
    "state": { "type": "string", "enum": ["queued", "sent", "delivered", "bounced", "complaint"] },
    "last_event_at": { "type": "string", "format": "date-time" },
    "detail": { "type": "string" }
  }
}

Exemple d’invocation

{
  "tool": "email_status",
  "arguments": { "message_id": "msg_01JK3QZ5Z9" }
}

Exemple de réponse

{
  "message_id": "msg_01JK3QZ5Z9",
  "state": "delivered",
  "last_event_at": "2026-04-22T13:02:14Z",
  "detail": "250 OK"
}

Sondez en back-off exponentiel jusqu’à delivered ou un état terminal. Les rejets remontent en bounced avec une chaîne de détail RFC 5321.