API
Mail System

Communication Layer For Outputs And Alerts

The mail surface exists so workflows and services can deliver useful outcomes: transactional email, notification messages, and system alerts.

mail.iai.one

Transactional Email

Receipts, confirmations, and execution reports.

Notification

Human-facing updates triggered by workflows or platform events.

System Alert

Operational messages for failures, exceptions, and runtime incidents.

Use Cases

Flow Output → Email

Send the result of a workflow to a user, operator, or team inbox.

System Alerts

Notify operators when a runtime step fails, retries, or exceeds policy.

User Notification

Deliver final messages into the user-facing layer without coupling mail logic into the builder itself.

API

POST/api/mail/send

{
  "to": "team@example.com",
  "subject": "Execution completed",
  "body": "The flow finished successfully."
}
{
  "ok": true,
  "data": {
    "messageId": "mail_123",
    "status": "queued"
  }
}

Future Direction

Inbox

First-party delivery surface for viewing platform mail inside the ecosystem.

Thread

Conversation and workflow history grouped into coherent operator context.

AI Mail Routing

Future model-assisted triage, categorization, and escalation behavior.

Boundary with app.iai.one

Mail delivers messages. app.iai.one is the surface where operators review those messages, manage incidents, or trigger follow-up actions.