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

# Allow & block lists

> Control who agents can send to, receive from and reply to.

# Lists

`/v0/emails/lists/:direction/:type…` (org) · inbox and project twins.
`direction` ∈ `send | receive | reply`, `type` ∈ `allow | block`.
Entries are email addresses or domains (`entry_type` is derived).

```bash theme={null}
curl -X POST $BASE/v0/emails/lists/send/block \
  -H "authorization: Bearer $KEY" -H 'content-type: application/json' \
  -d '{"entry":"spam@evil.com","reason":"abuse"}'
```

Enforcement is hierarchical (inbox → project → org): a `block` hit rejects
(`email.rejected` on send; `blocked` label on receive), and a non-empty
`allow` list rejects everything not on it. `GET …/:entry`, `DELETE …/:entry`.
Read-only entries (platform-managed) return 403 on delete.