---
title: "PUT /v2/chats/{chat_id}/notification-preferences"
method: PUT
path: "/v2/chats/{chat_id}/notification-preferences"
tags: ["Notifications"]
---

# PUT /v2/chats/{chat_id}/notification-preferences

`PUT /v2/chats/{chat_id}/notification-preferences`

## Request

- Base URL: `https://api.arbital.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.arbital.xyz/v2/chats/{chat_id}/notification-preferences`
- Auth: HTTP bearer

Authenticated current-policy notification operation. Responses are private, no-store. Capability gates may keep this operation unavailable until the reviewed migration and source contracts are admitted.

## Path parameters

- `chat_id` string, uuid, required

## Request body

- ChatNotificationPreferencesPutV2
  - `expected_version` string, required
  - `muted` boolean, required
  - `mute_until_unix_ms` integer, nullable, required
  - `group_level` 'all' | 'relevant' | 'none'

## Response `200`

Authorized notification response

- ChatNotificationPreferencesV2
  - `version` string, required
  - `muted` boolean, required
  - `mute_until_unix_ms` integer, nullable, required
  - `group_level` 'all' | 'relevant' | 'none' | 'null', nullable, required
  - `supported_levels` string[], required
  - `effective_push` boolean, required
  - `suppression_reasons` string[], required

## Other responses

- `400`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `401`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `404`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `409`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `410`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `413`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `503`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.

---

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