> For an agent: the map of this documentation is at https://escouade.io/en/mail/docs/llms.txt; every page exists in Markdown, at the same address with `.md` appended.

# `add_suppression`

Block an address or a domain.

Adds an address or a whole domain to the space's block list: nothing more will be sent to them, and whatever was waiting to leave towards them is cancelled. Use it as soon as a correspondent asks not to be contacted again. A public mail service (gmail.com…) cannot be blocked as a whole. Lifting the block afterwards (remove_suppression) needs the approve permission: an agent without it cannot undo it alone.

## Access

- **Key**: an Escouade Mail key with `send` or `approve`.
- **Space**: any space, verified or not.
- **Changes nothing**: no, it acts.
- **Safe to replay**: yes.

## Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `address` | string | yes | An address (marie@example.com) or a whole domain (@example.com). |
| `note` | string | no | Why, for the log. |

## Call it

```sh
curl -s https://api.subagent.fr/v1/add_suppression \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sak_…' \
  -d '{"address": "…"}'
```

The full page in French, with the response fields and every refusal the tool can return: [/mail/docs/reference/add_suppression](https://escouade.io/mail/docs/reference/add_suppression).