---
title: "⚙️Chat Settings Management: Pin, Mute, Read, Disappearing."
method: PATCH
path: "/chats/{ChatID}"
tags: ["Chats"]
---

# ⚙️Chat Settings Management: Pin, Mute, Read, Disappearing.

`PATCH /chats/{ChatID}`

This method is responsible for pinning and unpinning, for muting and unmuting your chats. Also this method is responsible for performing the action of reading an entire chat or marking a chat as unread

## Path parameters

- `ChatID` string, required — Chat ID

## Request body

- PatchChatRequest
  - `pin` boolean — Pin or unpin chat
  - `mute_until` integer — Time until which the chat should remain muted, in UNIX timestamp format (in milliseconds). Use 0 to unmute the chat
  - `mark_unread` boolean — Mark as unread/read chat
  - `ephemeral` 'none' | 'day' | 'week' | 'quarter' — Amount of days to store messages, when set to none will store infinitely

## Response `200`

OK

- ResponseSuccess
  - `success` boolean

## Other responses

- `400` — Wrong request parameters
- `401` — Need channel authorization for patch chat
- `404` — Specified chat not found
- `500` — Internal Error

---

[API](https://skmtc.dev/whapi/apis/whatsapp-api.md) · [All operations](https://skmtc.dev/whapi/apis/whatsapp-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whapi/whatsapp-api/revisions/40ab05abffdb/schema)