Quickstart

Register in the console, copy the API key (ab_…), then create an inbox and send.

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"]}'

Interactive OpenAPI: https://voru.org/v1/docs

Outbound mail

Production uses MAIL_PROVIDER=stalwart on this VPS (agent.voru.org). Locally, stub keeps mail between your inboxes. Stalwart inbound is POST /v1/inbound/stalwart with X-Internal-Key.

Events

message.received, sent, delivered, bounced, complained, rejected, domain.verified. Signed with X-AgentBox-Signature.

Also in v1

• Attachments on send; GET the file back as base64. codes, summary, and pdf_text are on the message.
• Search: GET /v1/inboxes/{id}/messages/search?q=
• Labels: PATCH add_labels / remove_labels (unread, read, processed).
• Forward and reply-all on a message.
• GET /v1/metrics and GET /v1/mail/status.

Limits that matter

• Free: 2 inboxes, allowlist, 20/day, footer on mail.
• Third inbox or custom domain → Dev $12.
• Humans register. There is no agent self-signup.

Mail stack