---
title: "Overall Channel level"
method: PATCH
path: "/v1/user/{distinct_id}/preference/channel_preference/"
---

# Overall Channel level

`PATCH /v1/user/{distinct_id}/preference/channel_preference/`

API to update user preferences across all channels.

## Path parameters

- `distinct_id` string, required

## Query parameters

- `tenant_id` string

## Request body

- object
  - `channel_preferences` object[] — Use this to update channel level user preferences. Set `is_restricted - true` if the channel is opted_out by the user. This will only send critical notifications to the user which can't be opted out
    - `channel` string — Add channel as `email`, `inbox`, `sms`, `whatsapp`, `androidpush`, `slack`, `iospush`, `webpush`
    - `is_restricted` boolean — set `is_restricted = true` if user wants to receive notification in mandatory categories on this channel. Mandatory categories are `can't unsubscribe` categories and the above channel is added as `mandatory channel` in that category

## Response `202`

202

- object
  - `channel_preferences` object[]
    - `channel` string
    - `is_restricted` boolean

## Other responses

- `400` — 400 - Bad Request

---

[API](https://skmtc.net/suprsend/apis/suprsend-api.md) · [All operations](https://skmtc.net/suprsend/apis/suprsend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/suprsend/suprsend-api/versions/8bd2574bd2c3/schema)