> ## 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.

# Authentication

> API key authentication and scopes.

All API requests use bearer auth:

```http theme={null}
Authorization: Bearer <api_key>
```

## Scope model

Common scopes:

* `inboxes:read`, `inboxes:write`
* `emails:read`, `emails:write`, `emails:send`
* `domains:read`, `domains:write`
* `keys:read`, `keys:write`
* `metrics:read`
* `*` for full access

If scope is missing, API returns `403`.

If API key is missing or invalid, API returns `401`.