# A recipient opted out

Source: https://docs.usetone.ai/reference/compliance/consent.optOut

> Revokes every active consent for the number and suppresses it for the 90-day re-consent lockout, in one transaction.

`POST /v1/consent/opt-out`
Revokes every active consent for the number and suppresses it for the 90-day re-consent lockout, in one transaction.

Requires the `write` scope.

## Request body

| Field | Type | | Meaning |
|---|---|---|---|
| `e164` | string | required | The number that opted out, in E.164. |
| `reason` | string | optional | Free text kept with both the revocation and the suppression entry. |

### Example request

```json
{
  "e164": "+919876543210",
  "reason": "Said \"do not call me again\" during the call."
}
```

## Response

| Field | Type | | Meaning |
|---|---|---|---|
| `revoked` | integer | required | Active consents revoked. The 90-day suppression is written in the same transaction, whatever this number is. |

### Example response

```json
{
  "data": {
    "revoked": 0
  }
}
```