> ## Documentation Index
> Fetch the complete documentation index at: https://docs.emailagent.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Emails API

> Send outbound email and consume inbound/outbound records.

Endpoints:

* `POST /api/v1/emails/send`
* `GET /api/v1/emails`
* `PATCH /api/v1/emails/{id}/read`
* `DELETE /api/v1/emails/{id}`

Use `Idempotency-Key` for retries and to avoid duplicate sends.

Required scopes:

* `emails:send` for `POST /api/v1/emails/send`
* `emails:read` for `GET /api/v1/emails`
* `emails:write` for `PATCH /api/v1/emails/{id}/read` and `DELETE /api/v1/emails/{id}`

Example:

```bash theme={null}
curl -X GET "https://api.emailagent.dev/api/v1/emails?inboxId=<inbox_uuid>" \
  -H "Authorization: Bearer <api_key>"
```