---
title: "Update notification settings of a user."
method: POST
path: "/api/workspaces/notifications/settings"
tags: ["Notification Settings"]
---

# Update notification settings of a user.

`POST /api/workspaces/notifications/settings`

## Request

- Base URL: `https://app.airfocus.com`
- URL: `https://app.airfocus.com/api/workspaces/notifications/settings`
- Auth: HTTP bearer

Requirements:<br/>- auth-client scopes: "profile"

## Request body

- NotificationSettingUpdateRequest
  - `settings` NotificationSettingsData, required
    - `deliveryPreferences` DeliveryPreferences
      - `addedUserToPokerGame` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `appNotification` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `assignedUserToItem` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `commentedOnDocument` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `commentedOnItem` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `healthCheckInModification` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `mentions` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `reactedToComment` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `requestedWorkspacePermission` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `updatedItemStatus` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `workspaceMembership` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
    - `enableAgentNotifications` boolean

## Response `200`

- NotificationSettings
  - `createdAt` string, date-time, required
  - `lastUpdatedAt` string, date-time, required
  - `settings` NotificationSettingsData, required
    - `deliveryPreferences` DeliveryPreferences
      - `addedUserToPokerGame` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `appNotification` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `assignedUserToItem` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `commentedOnDocument` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `commentedOnItem` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `healthCheckInModification` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `mentions` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `reactedToComment` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `requestedWorkspacePermission` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `updatedItemStatus` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
      - `workspaceMembership` ChannelPreferences
        - `email` boolean
        - `inApp` boolean
    - `enableAgentNotifications` boolean
  - `userId` string, uuid, required

## Other responses

- `400`: If payload is invalid or resource does not exist.
- `401`: If missing authentication token.
- `403`: If authenticated client does not have the required access scopes.
- `default`: If any other error happens.

---

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