`email_status`

Fetch delivery status for a previously sent message.

Category: Email
Stability: Beta
Version: v1
Auth: cf-access

Input schema

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

Output schema

{
  "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" }
  }
}

Example invocation

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

Example response

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

Poll in exponential backoff until delivered or a terminal state. Bounces surface as bounced with an RFC 5321 detail string.