# Set notification preferences

`PUT /v1/notifications/preferences`

email: off (default), mentions (mail for mentions), all (every notification).

Scope: `docs:write`.

## Request

```bash
curl -X PUT "https://api.lydie.co/v1/notifications/preferences" \
  -H "Authorization: Bearer $LYDIE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "off"
  }'
```

## Body

- `email` (string, required): One of: `off`, `mentions`, `all`.

## Response

- `email` (string, required): One of: `off`, `mentions`, `all`.

```json
{
  "email": "off"
}
```

Errors use the envelope described at https://developers.lydie.co/errors.md.