A headless email client: IMAP and SMTP mailboxes behind a plain REST interface.
partReaching people22 operationsid email
How it sits
A part does one thing, and any other part can call it. The counts and the links below are from the platform's spec and the other services' own descriptions.
| Operations | 22 GET 10 · POST 9 · DELETE 3 |
| Resources | 7 |
| Leaned on by | Notify, Snail mail |
| Leans on | none named |
| In recipes | none yet |
What it can do
22 operations in 7 resources, as the spec declares them. Each row is one call; paths are relative to the part.
mailbox
| Method | Path | Does |
|---|---|---|
| GET | /api/mailbox/folders | List all mailbox folders |
| POST | /api/mailbox/folders | Create a new folder |
| DELETE | /api/mailbox/folders/{name} | Delete a folder |
| GET | /api/mailbox/messages | List messages in a folder |
| DELETE | /api/mailbox/messages/{uid} | Delete a message |
| GET | /api/mailbox/messages/{uid} | Get a single message |
| GET | /api/mailbox/messages/{uid}/attachments/{index} | Download an attachment's bytes |
| POST | /api/mailbox/messages/{uid}/mark | Mark a message (read/unread/flagged) |
| POST | /api/mailbox/messages/{uid}/move | Move a message to another folder |
9 operations
sessions
| Method | Path | Does |
|---|---|---|
| POST | /api/sessions | Create a new email session |
| DELETE | /api/sessions/{session_id} | Delete/revoke a session |
| GET | /api/sessions/{session_id} | Get session information |
| GET | /api/sessions/{session_id}/health | Check session connectivity |
4 operations
send
| Method | Path | Does |
|---|---|---|
| POST | /api/send | Send a single email |
| POST | /api/send/batch | Send multiple emails in a batch |
| POST | /api/send/list | Send a templated email to every member of a Lists |
3 operations
health
| Method | Path | Does |
|---|---|---|
| GET | /health | Basic health check |
| GET | /health/detailed | Detailed health check |
2 operations
internal
| Method | Path | Does |
|---|---|---|
| POST | /api/internal/send | Send email (internal, no auth) |
| POST | /api/internal/sessions/prune | Soft-revoke stale sessions (internal, no auth) |
2 operations
prime
| Method | Path | Does |
|---|---|---|
| GET | /prime | Prime application caches |
1 operation
status
| Method | Path | Does |
|---|---|---|
| GET | /status | Service status overview |
1 operation
All the partsReaching peopleThe platform's own id for this service is cbemail.
forge-catalog.json, generated Oct 30, 2026