---
title: "Change your notification preferences"
method: PATCH
path: "/v1/notification-preferences"
tags: ["Notifications"]
---

# Change your notification preferences

`PATCH /v1/notification-preferences`

## Request

- Base URL: `https://api.ironfang.com/security`
- URL: `https://api.ironfang.com/security/v1/notification-preferences`
- Auth: HTTP bearer

For each channel: leave it out to keep it, send an object to save your own filters, or `null` to return to the recommended set. Needs security.read only: these are your own.

## Request body

- object
  - `email` NotificationPreference
    - `certificate_alerts` boolean, required: Replaced certificates and expiry milestones.
    - `dns_changes` boolean, required: DNS and email records.
    - `enabled` boolean, required
    - `exposure_changes` boolean, required
    - `minimum_severity` 'critical' | 'high' | 'medium' | 'low' | 'info', required
    - `monitoring_failures` boolean, required: Scheduled checks that could not complete, and pauses.
    - `new_findings` boolean, required: New issues, returns and severity increases.
    - `resolved_findings` boolean, required: Resolved issues and improvements.
  - `in_app` NotificationPreference
    - `certificate_alerts` boolean, required: Replaced certificates and expiry milestones.
    - `dns_changes` boolean, required: DNS and email records.
    - `enabled` boolean, required
    - `exposure_changes` boolean, required
    - `minimum_severity` 'critical' | 'high' | 'medium' | 'low' | 'info', required
    - `monitoring_failures` boolean, required: Scheduled checks that could not complete, and pauses.
    - `new_findings` boolean, required: New issues, returns and severity increases.
    - `resolved_findings` boolean, required: Resolved issues and improvements.

## Response `200`

The preferences now.

- NotificationPreferences
  - `email` ChannelPreference, required
    - `certificate_alerts` boolean, required: Replaced certificates and expiry milestones.
    - `dns_changes` boolean, required: DNS and email records.
    - `enabled` boolean, required
    - `exposure_changes` boolean, required
    - `minimum_severity` 'critical' | 'high' | 'medium' | 'low' | 'info', required
    - `monitoring_failures` boolean, required: Scheduled checks that could not complete, and pauses.
    - `new_findings` boolean, required: New issues, returns and severity increases.
    - `resolved_findings` boolean, required: Resolved issues and improvements.
    - `custom` boolean, required: False while the recommended set applies.
  - `in_app` ChannelPreference, required
    - `certificate_alerts` boolean, required: Replaced certificates and expiry milestones.
    - `dns_changes` boolean, required: DNS and email records.
    - `enabled` boolean, required
    - `exposure_changes` boolean, required
    - `minimum_severity` 'critical' | 'high' | 'medium' | 'low' | 'info', required
    - `monitoring_failures` boolean, required: Scheduled checks that could not complete, and pauses.
    - `new_findings` boolean, required: New issues, returns and severity increases.
    - `resolved_findings` boolean, required: Resolved issues and improvements.
    - `custom` boolean, required: False while the recommended set applies.

## Other responses

- `400`: An error.
- `default`: An error.

---

[API](https://skmtc.dev/ironfang/apis/ironfang-security-api.md) · [All operations](https://skmtc.dev/ironfang/apis/ironfang-security-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ironfang/apis/ironfang-security-api/revisions/73bd66283d59?raw)