Mailbuttons Agent Mail API
API by Mailbuttons · rest
REST API for provisioning and operating governed email accounts for AI agents, on mbag.ai and mailbuttons.com. Authenticate with a Bearer API key: mbk_-prefixed when obtained via the OTP flow below (see /auth/otp/cli-exchange); dashboard-issued keys carry no prefix.
Endpoint: https://mailbuttons.com/api
Verification: observed. Source: crawl.
Capabilities (29)
- Verify a one-time code and mint a CLI API key
- Request a one-time login/signup code by email
- Verify a one-time code and start a browser session
- Forward a raw JMAP method-call request to the mailbox's own Stalwart principal
- Fetch the JMAP session object for the mailbox's own Stalwart principal
- List the caller's mailboxes
- Provision a new mailbox
- Get a mailbox by id
- Update a mailbox's name description or active flag
- Delete a mailbox
- Get a short-lived presigned URL for the mailbox's `.mv2` memory file
- Acquire a short exclusive lock on the mailbox's `.mv2` memory file
- Get the mailbox's `.mv2` memory file metadata
- Release the mailbox's `.mv2` memory file lock
- Upload (or replace) the mailbox's `.mv2` memory file
- List recent messages in a mailbox optionally since a cursor
- Get one full email including body text and threading headers
- Download one attachment's bytes
- Send a notification-style bounce to the original sender
- Reply to one email
- Get a mailbox's mail policy
- Replace a mailbox's mail policy
- Compose and send a fresh email from a mailbox you own
- List a mailbox's threads newest first
- Get one thread with its messages