# Messenger settings

Reading and changing the user's general messenger settings and status — the same ones the user sees in the Bitrix24 messenger settings window.

**Scope:** `im` | **Base URL:** `https://vibecode.bitrix24.com/v1` | **Authorization:** `X-Api-Key`

## Operations

- [Read settings](./settings/list.md) — `GET /v1/chats/settings`
- [Change a setting](./settings/update.md) — `PATCH /v1/chats/settings`
- [User status](./settings/status.md) — `PUT /v1/chats/settings/status`

## Whose settings

Without `userId`, the operations work with the key owner's settings: the platform resolves the owner and passes their ID to Bitrix24. Only a Bitrix24 administrator can read and change another user's settings — everyone else gets `422 BITRIX_ERROR` with the `SETTINGS_ACCESS_DENIED` code in `error.b24Code`.

The status is a setting too: the `status` field in the [read settings](./settings/list.md) response. It can be changed only through the separate [set status](./settings/status.md) operation, which updates both the setting and the status every messenger client sees.

## See also

- [Chats and messages](/docs/chats)
- [Service methods](/docs/chats/service)
- [Notifications](/docs/notifications)