快速开始

在控制台注册，复制 API Key（ab_…），然后创建收件箱并发送。

curl -X POST https://voru.org/v1/inboxes \
  -H "X-API-Key: ab_..." \
  -H "Content-Type: application/json" \
  -d '{"display_name":"support-bot"}'

curl -X POST https://voru.org/v1/inboxes/<id>/messages/send \
  -H "X-API-Key: ab_..." \
  -H "Content-Type: application/json" \
  -d '{"to":"you@example.com","subject":"Hello","text":"Hi","labels":["outreach"]}'

交互式 OpenAPI：https://voru.org/v1/docs

外发邮件

生产环境 MAIL_PROVIDER=stalwart，域是 agent.voru.org。本地 stub 只在 inbox 之间投递。Stalwart 入站是 POST /v1/inbound/stalwart，头 X-Internal-Key。

事件

message.received / sent / delivered / bounced / complained / rejected / domain.verified。签名头 X-AgentBox-Signature。

v1 里还有

• 发送可带附件；GET 回 base64。消息上还有 codes、summary、pdf_text。
• 搜索：GET /v1/inboxes/{id}/messages/search?q=
• 标签：PATCH add_labels / remove_labels（unread、read、processed）。
• 转发与全部回复。
• GET /v1/metrics 与 GET /v1/mail/status。

真正生效的限额

• 免费：2 个 inbox、白名单、每天 20 封、外发带页脚。
• 第三个 inbox 或自定义域 → Dev $12。
• 由人注册。没有 Agent 自助注册。

邮件栈