Changing the notification preference of the authenticated user

Note

The notification preference is only available for an organisation with the anomalies feature enabled, and only for users who are not a SOC admin or SOC user. SOC admins and SOC users must add their email address to the notification recipient list of the relevant organisation instead.

Sends a PATCH request to the endpoint /users/me/notification-preferences.

Description

The Change-Notification-Preferences request allows the user to change the mitigation and anomaly notification email preference of the authenticated user.

Requirements

Values of the request: none

Objects: NotificationPreferencesVO

Request

To change the notification preference, no additional information is required in the path of the request.

For a detailed specification of which information is required to change the notification preference, the object NotificationPreferencesVO with the following attribute needs to be defined in the body:

Attributes	Description	Values
notificationsEnabled	Whether the user is opted in to mitigation and anomaly notification emails.	true false

In response, the system returns the object ApiUser with the updated information.

The object provides the following information:

Attributes	Description	Values
id	The ID of the user.	string
name	The full name of the user.	string
email	The email address of the user.	string
notificationsEnabled	Whether the user is opted in to mitigation and anomaly notification emails.	true false
activeOrganisation	The organisation context in which the token is used.	object

Example

Example request body:

{
  "notificationsEnabled": true
}

Responses

The following responses are available:

STATUS CODE	DESCRIPTION
200	The request has succeeded.
401	The request has not succeeded because the user authentication was incorrect.
403	The request has not succeeded because the user does not have the right permissions.
422	The request was unsuccessful because the submitted data could not be processed.