# e2a API API

**Canonical:** https://apis.io/apis/e2a-dev/e2a-api-api/  
**Provider:** e2a-dev — https://apis.io/providers/e2a-dev/  
**Base URL:** https://api.e2a.dev  
**Documentation:** https://e2a.dev/openapi.yaml

e2a API API is one of 2 APIs that [e2a-dev](https://apis.io/providers/e2a-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

e2a — authenticated email gateway for AI agents. v1 contract.

## Operations (60 of 76)

| Method | Path | Summary |
|---|---|---|
| DELETE | `/v1/account` | Delete your account (trash by default; permanent=true erases now) |
| GET | `/v1/account` | Get account: identity + plan limits + usage (whoami) |
| GET | `/v1/account/api-keys` | List API keys |
| POST | `/v1/account/api-keys` | Create an API key |
| DELETE | `/v1/account/api-keys/{id}` | Revoke an API key |
| GET | `/v1/account/export` | Export your data (GDPR right-of-access) |
| GET | `/v1/account/sending-access/request` | Get your latest external sending access request (beta) |
| POST | `/v1/account/sending-access/request` | Request external sending access (beta) |
| GET | `/v1/account/suppressions` | List suppressed recipient addresses |
| DELETE | `/v1/account/suppressions/{address}` | Remove an address from the suppression list |
| GET | `/v1/agents` | List agents |
| POST | `/v1/agents` | Create an agent |
| DELETE | `/v1/agents/{email}` | Delete an agent |
| GET | `/v1/agents/{email}` | Get an agent |
| PATCH | `/v1/agents/{email}` | Update an agent |
| GET | `/v1/agents/{email}/contacts` | List an agent's outreach (beta) |
| DELETE | `/v1/agents/{email}/contacts/{address}` | Un-enrol a contact (beta) |
| GET | `/v1/agents/{email}/contacts/{address}` | Get one outreach record (beta) |
| PUT | `/v1/agents/{email}/contacts/{address}` | Enrol or update outreach state (beta) |
| GET | `/v1/agents/{email}/conversations` | List conversations |
| GET | `/v1/agents/{email}/conversations/{id}` | Get a conversation |
| GET | `/v1/agents/{email}/messages` | List messages |
| POST | `/v1/agents/{email}/messages` | Send a new email |
| DELETE | `/v1/agents/{email}/messages/{id}` | Delete a message (move to trash) |
| GET | `/v1/agents/{email}/messages/{id}` | Get a message |
| PATCH | `/v1/agents/{email}/messages/{id}` | Update a message (labels) |
| GET | `/v1/agents/{email}/messages/{id}/attachments/{index}` | Get an attachment (metadata + short-lived download URL) |
| POST | `/v1/agents/{email}/messages/{id}/forward` | Forward a message |
| GET | `/v1/agents/{email}/messages/{id}/lifecycle` | Get a message's lifecycle (beta) |
| POST | `/v1/agents/{email}/messages/{id}/reply` | Reply to a message |
| POST | `/v1/agents/{email}/messages/{id}/restore` | Restore a message from the trash |
| GET | `/v1/agents/{email}/metrics` | Get an agent's delivery metrics (beta) |
| GET | `/v1/agents/{email}/protection` | Get an agent's protection config (beta) |
| PUT | `/v1/agents/{email}/protection` | Replace an agent's protection config (beta) |
| POST | `/v1/agents/{email}/restore` | Restore an agent from the trash |
| GET | `/v1/agents/{email}/suppressions` | List an agent's suppressed recipients (beta) |
| POST | `/v1/agents/{email}/suppressions` | Suppress a recipient for an agent (beta) |
| DELETE | `/v1/agents/{email}/suppressions/{address}` | Remove an agent recipient suppression (beta) |
| POST | `/v1/agents/{email}/test` | Send a test email to the agent's own address |
| GET | `/v1/contacts` | List contacts (beta) |
| POST | `/v1/contacts` | Create a contact (beta) |
| POST | `/v1/contacts/import` | Import contacts in bulk (beta) |
| DELETE | `/v1/contacts/imports/{batch_id}` | Reverse a contact import (beta) |
| DELETE | `/v1/contacts/{address}` | Delete a contact (beta) |
| GET | `/v1/contacts/{address}` | Get a contact (beta) |
| PATCH | `/v1/contacts/{address}` | Update a contact (beta) |
| GET | `/v1/domains` | List domains |
| POST | `/v1/domains` | Register a domain |
| DELETE | `/v1/domains/{domain}` | Delete a domain |
| GET | `/v1/domains/{domain}` | Get a domain |
| POST | `/v1/domains/{domain}/verify` | Verify a domain |
| GET | `/v1/events` | List events |
| GET | `/v1/events/{id}` | Get an event |
| POST | `/v1/events/{id}/redeliver` | Redeliver an event |
| GET | `/v1/info` | Deployment info |
| GET | `/v1/metrics` | Get account-wide delivery metrics (beta) |
| GET | `/v1/reviews` | List messages awaiting review (beta) |
| GET | `/v1/reviews/{id}` | Get a held message (full detail, beta) |
| POST | `/v1/reviews/{id}/approve` | Approve a held message (beta) |
| POST | `/v1/reviews/{id}/reject` | Reject a held message (beta) |

…and 16 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/e2a-dev/openapi/_original/e2a-dev-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/e2a-dev/json-schema/e2a-dev-message-view-schema.json
- **JSONSchema** — https://artifacts.apis.io/e2a-dev/json-schema/e2a-dev-send-email-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/e2a-dev/json-schema/e2a-dev-reply-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/e2a-dev/json-schema/e2a-dev-forward-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/e2a-dev/json-schema/e2a-dev-contact-engagement-view-schema.json
- **JSONSchema** — https://artifacts.apis.io/e2a-dev/json-schema/e2a-dev-verify-domain-view-schema.json

## Other e2a-dev APIs (1)

- [e2a.dev Email API](https://apis.io/apis/e2a-dev/e2a-dev-email-api/)

---

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