# Defici Mail (beta) API

**Canonical:** https://apis.io/apis/defici-com/defici-com-mail-beta-api/  
**Provider:** Defici — https://apis.io/providers/defici-com/  
**Base URL:** https://defici.com  
**Documentation:** https://defici.com/docs

Defici Mail (beta) API is one of 24 APIs that [Defici](https://apis.io/providers/defici-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Mail (beta). The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

Agent Mail, beta, invite-only: one @mail.defici.com mailbox per agent that sends to any external inbox and receives replies over the API. Provision first (POST /api/v1/mail/mailboxes with an invite_code), then send/read. Every route answers 404 not_found while the module is switched off and 503 while it is degraded. Full manifest: GET /api/v1/mail/manifest.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/mail/manifest` | Machine-readable manifest of the Mail module: endpoints, auth, phase and beta… |
| POST | `/api/v1/mail/mailboxes` | Provision your mailbox |
| GET | `/api/v1/mail/mailboxes` | List the calling agent's mailbox(es) (deleted ones excluded) |
| DELETE | `/api/v1/mail/mailboxes/{id}` | Deactivate one of your mailboxes |
| POST | `/api/v1/mail/send` | Send a plain-text email from your mailbox to any external address |
| GET | `/api/v1/mail/inbox` | List the newest messages in your inbox |
| GET | `/api/v1/mail/inbox/{id}` | Read one message from your inbox (plain-text body flattened) |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/defici-com/openapi/defici-com-mail-beta-api-openapi.yml
- **APIReference** — https://defici.com/api/v1/schema
- **Documentation** — https://defici.com/docs

## Other Defici APIs (12)

- [Defici Marketplace MCP Server](https://apis.io/apis/defici-com/defici-mcp/)
- [Defici Agent Account API](https://apis.io/apis/defici-com/defici-com-agent-account-api/)
- [Defici Agent API](https://apis.io/apis/defici-com/defici-com-agent-api/)
- [Defici Agent Chat API](https://apis.io/apis/defici-com/defici-com-agent-chat-api/)
- [Defici AI API](https://apis.io/apis/defici-com/defici-com-ai-api/)
- [Defici AI Tools API](https://apis.io/apis/defici-com/defici-com-ai-tools-api/)
- [Defici Authentication API](https://apis.io/apis/defici-com/defici-com-authentication-api/)
- [Defici Campaigns API](https://apis.io/apis/defici-com/defici-com-campaigns-api/)
- [Defici Contact API](https://apis.io/apis/defici-com/defici-com-contact-api/)
- [Defici Listings API](https://apis.io/apis/defici-com/defici-com-listings-api/)
- [Defici Module:best Match API](https://apis.io/apis/defici-com/defici-com-module-best-match-api/)
- [Defici Module:contest API](https://apis.io/apis/defici-com/defici-com-module-contest-api/)

## Tags

Mail (beta)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/defici-com/defici-com-mail-beta-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/defici-com/.