---
title: "Update notification"
method: PATCH
path: "/notifications/{notification_id}"
tags: ["Notifications"]
---

# Update notification

`PATCH /notifications/{notification_id}`

Update an existing notification owned by the current account. All type-specific rules from creation apply.

## Path parameters

- `notification_id` integer, required — ID of the notification.

## Request body

- NotificationCreateRequest
  - `method_id` integer, nullable — Notification method ID to use.
  - `type` 'email' | 'domain' | 'advanced' | 'raw' | 'dark_web', required
  - `value` string, nullable — Value to monitor (required for EMAIL/DOMAIN types).
  - `filters` object, nullable — Filters when type=ADVANCED or RAW. Parsed according to type.
  - `auto_unlock` boolean, nullable — If true, automatically unlock new matching leaks (consumes points).
  - `max_points` integer, nullable — Daily points cap for auto-unlock (if enabled).
  - `second_type` 'ALL' | 'EMPLOYEES' | 'THIRD_PARTIES' | 'CUSTOMERS'
  - `bulk` boolean, nullable — Create multiple notifications at once (e.g., newline-separated values).

## Response `200`

Notification updated successfully.

- NotificationOut
  - `id` integer, required — Notification ID.
  - `method_id` integer, required — ID of the notification method used for delivery.
  - `type` 'email' | 'domain' | 'advanced' | 'raw' | 'dark_web', required
  - `second_type` 'ALL' | 'EMPLOYEES' | 'THIRD_PARTIES' | 'CUSTOMERS'
  - `value` string, nullable — Monitored value (email address, domain, search query, etc.).
  - `filters` object, nullable — Additional search filters applied to this notification.
  - `last_searched_at` string, date-time, nullable — Last time this notification was checked for new results.
  - `is_active` boolean, required — Whether this notification is currently active.
  - `timestamp` string, date-time, required — Creation date of this notification.
  - `method_type` 'email' | 'slack' | 'telegram' | 'webhook' | 'discord'
  - `method_value` string, nullable — Destination of the associated method.
  - `method_extra_emails` string[], nullable — Additional BCC recipients of the associated method (email methods only).
  - `auto_unlock` boolean, nullable — Whether new results are automatically unlocked.
  - `max_points` integer, nullable — Maximum points to spend per notification run for auto-unlock.
  - `daily_spent` integer, nullable — Points spent today by auto-unlock on this notification.
  - `daily_reset_at` string, date-time, nullable — Next daily reset time for the spent counter.
  - `total_notifications` integer, nullable — Total number of notification runs executed.
  - `total_cost` integer, nullable — Total points consumed by this notification across all runs.

## Other responses

- `400` — Invalid parameters.
- `401` — Authentication required.
- `403` — Feature not included in your plan.
- `404` — Notification not found.
- `422` — Validation error.

---

[API](https://skmtc.dev/leakradar/apis/leakradar-io-api.md) · [All operations](https://skmtc.dev/leakradar/apis/leakradar-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/leakradar/leakradar-io-api/revisions/82a99c608e1a/schema)