Approve AI Agent Actions by Email

Description and use

Email notifications enable reviewers to approve AI agent actions without extra apps, streamlining the approval workflow.

Problem

Reviewers need a simple way to approve AI agent actions without installing extra chat apps.

Outcome

Email notifications provide a low‑overhead approval workflow for AI agents, enabling reviewers to approve actions from any device without extra apps.

Workflow

• Configure SMTP on the server to enable email delivery.
• Create an email notification channel via POST /v1/notification-channels with name, type 'email', and recipient address.
• Set digest_window_sec to 300-600 seconds to batch bursts of actions into a single email.
• When an agent generates a pending action, POST /v1/actions with action details and preview.
• Monitor the action status via GET /v1/actions/{id} until status changes from 'pending'.
• If status is 'approved', retrieve final_preview and perform the action (e.g., create calendar event).
• POST /v1/actions/{id}/result with status 'executed' to mark completion.
• Handle delivery failures: after five failures, the channel is disabled automatically.
• Reviewers check Settings → Notifications if emails stop arriving.

Evidence

Route every pending AI agent action to your email inbox, so approving what an agent wants to do takes nothing more than a mail client you already use daily.

Source

Five consecutive delivery failures — bad SMTP config, a bounced address — disable the channel automatically instead of retrying silently.

Source