SDK / API Reference
Messages
Send, read, reply to, label, and delete email messages
The messages API is the SDK surface for everything an agent does with mail: send a new message, read the inbox, reply on a thread, mark messages with labels, or delete them. Every endpoint here is also available via loomal.mail.* in the Node and Python SDKs, the loomal mail CLI, and as MCP tools — see each endpoint page for the per-channel snippets.
| Endpoint | What it does |
|---|---|
| Send a message | POST /v0/messages/send — send a new email |
| Reply | POST /v0/messages/:id/reply — reply on the same thread |
| List messages | GET /v0/messages — list the inbox, filter by labels |
| Get message | GET /v0/messages/:id — fetch one parsed message |
| Update labels | PATCH /v0/messages/:id/labels — add or remove labels |
| Delete message | DELETE /v0/messages/:id — delete a message |
| Attachments | GET /v0/messages/:id/attachments/:attachmentId — download bytes |