---
title: "Update Notification Preferences"
method: PUT
path: "/notifications/preferences"
tags: ["Notifications"]
---

# Update Notification Preferences

`PUT /notifications/preferences`

## Request

- Base URL: `https://api-v2.pandavideo.com.br`
- URL: `https://api-v2.pandavideo.com.br/notifications/preferences`
- Auth: API key in header `Authorization`

Enables or disables event-channel pairs. Only the pairs sent are changed; the response is the full matrix. Send {"action":"restore_defaults"} to reset all preferences to their defaults.

## Request body

- object
  - `preferences` object[]: Pairs to update. Only the pairs sent are changed.
    - `event_type` string, required: Event identifier.
    - `channel` string, required: Delivery channel. Uppercase: EMAIL, SMS, WHATSAPP, DASHBOARD.
    - `enabled` boolean, required: Enable or disable this pair.
  - `action` 'restore_defaults': Send restore_defaults (without preferences) to reset all preferences to their defaults.

## Response `200`

Updated preference matrix

- object
  - `preferences` object[]: Array of 40 event-channel pairs.
    - `event_type` string
    - `category` string
    - `channel` string
    - `enabled` boolean
    - `mandatory` boolean
    - `available` boolean
    - `default_enabled` boolean

## Other responses

- `400`: Validation error
- `401`: Unauthorized

---

[API](https://skmtc.dev/pandavideo/apis/panda-notifications-api.md) - [All operations](https://skmtc.dev/pandavideo/apis/panda-notifications-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pandavideo/apis/panda-notifications-api/revisions/7ec520d6ac08?raw)