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

# Update a notification

`PATCH /notifications/{id}`

Update an existing notification. You can add additional emails or change the action or users that cause a notification to trigger. 

When updating recipient emails, make sure your `recipients` parameter contains the full list of people who should be included on the notification. If you resend the list without an existing recipient, they will be deleted from the notification emails. 

**Notes:**

- You need to have the [notifications permission](/docs/account/04-users/00-introduction#managing-user-roles-and-permissions) to update a notification.
- You can only change notifications owned by your user account.

## Path parameters

- `id` integer, required

## Headers

- `ev-api-key` string, required
- `ev-access-token` string, required

## Request body

- object
  - `action` 'upload' | 'download' | 'delete' | 'all' — Type of action be notified about. Notifications will only be sent for the given type of action. Valid choices are **upload**, **download**, **delete** or **all** (upload/download/delete)
  - `usernames` string[] — Determines which users' actions should trigger the notification. Rather than listing individual users, you can also use 3 special options: - **notice\_user\_all** for activity by any user or share recipient - **notice\_user\_all\_users** for activity only by user accounts - **notice\_user\_all\_recipients** for activity only by share recipients
  - `sendEmail` boolean — Whether an email should be sent to the recipients when matching activity happens.
  - `recipients` string[] — Email addresses to send notification emails to. If empty, sends to the current user's email address.
  - `message` string — Custom message to insert into the notification emails, along with the matching activity.

## Response `200`

Successful Operation

- NotificationResponse — unresolved $ref

---

[API](https://skmtc.net/prismic/apis/exavault-api.md) · [All operations](https://skmtc.net/prismic/apis/exavault-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prismic/exavault-api/revisions/a1bd874b5960/schema)