# Chat management

Create and change group chats, their description, color, avatar, member permissions and message auto-delete policy. Transfer ownership, manage notifications, join and leave chats, attach a parent chat, delete and pin chats, sort chats into personal folders, set an unread mark, and mark all chats or a list section as read.

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

## Operations

- [Create a group chat](./management/create.md) — `POST /v1/chats`
- [Rename a chat](./management/rename.md) — `PATCH /v1/chats/:chatId`
- [Transfer chat ownership](./management/owner.md) — `POST /v1/chats/:chatId/owner`
- [Leave a chat](./management/leave.md) — `POST /v1/chats/:chatId/leave`
- [Chat notifications](./management/mute.md) — `POST /v1/chats/:chatId/mute`
- [Change a chat description](./management/description.md) — `PUT /v1/chats/:dialogId/description`
- [Change a chat color](./management/color.md) — `PUT /v1/chats/:dialogId/color`
- [Change a chat avatar](./management/avatar.md) — `PUT /v1/chats/:dialogId/avatar`
- [Set the permission to post messages](./management/permissions-messages.md) — `PUT /v1/chats/:dialogId/permissions/messages`
- [Set the permission to invite guests](./management/permissions-guest-invites.md) — `PUT /v1/chats/:dialogId/permissions/guest-invites`
- [Set the permission to change chat settings](./management/permissions-settings.md) — `PUT /v1/chats/:dialogId/permissions/settings`
- [Set the permission to change chat appearance](./management/permissions-ui.md) — `PUT /v1/chats/:dialogId/permissions/ui`
- [Set the permission to add members](./management/permissions-users-add.md) — `PUT /v1/chats/:dialogId/permissions/users-add`
- [Set the permission to remove members](./management/permissions-users-delete.md) — `PUT /v1/chats/:dialogId/permissions/users-delete`
- [Configure message auto-delete](./management/auto-delete.md) — `PUT /v1/chats/:dialogId/auto-delete`
- [Set the "unread" mark](./management/unread-create.md) — `POST /v1/chats/:dialogId/unread`
- [Clear the "unread" mark](./management/unread-delete.md) — `DELETE /v1/chats/:dialogId/unread`
- [Create a chat folder](./management/folders-create.md) — `POST /v1/chats/folders`
- [Get a chat folder](./management/folders-get.md) — `GET /v1/chats/folders/:folderId`
- [Update a chat folder](./management/folders-update.md) — `PATCH /v1/chats/folders/:folderId`
- [Delete a chat folder](./management/folders-delete.md) — `DELETE /v1/chats/folders/:folderId`
- [Reorder chat folders](./management/folders-order.md) — `PUT /v1/chats/folders/order`
- [Add chats to a folder](./management/folder-chats.md) — `POST /v1/chats/folders/:folderId/chats`
- [Remove chats from a folder](./management/folder-chats-delete.md) — `DELETE /v1/chats/folders/:folderId/chats`
- [Set the folders of a chat](./management/folder-chats-set.md) — `PUT /v1/chats/:dialogId/folders`
- [Sources of the "All" folder](./management/folder-sources.md) — `GET /v1/chats/folders/:folderId/sources`
- [Set the sources of the "All" folder](./management/folder-sources-update.md) — `PUT /v1/chats/folders/:folderId/sources`
- [Pin a chat](./management/pin.md) — `POST /v1/chats/:dialogId/pin`
- [Pinned chat order](./management/pin-sort.md) — `PUT /v1/chats/:dialogId/pin`
- [Unpin a chat](./management/unpin.md) — `DELETE /v1/chats/:dialogId/pin`
- [Read all chats](./management/read-all.md) — `POST /v1/chats/read-all`
- [Read a list section](./management/read-section.md) — `POST /v1/chats/recent/read`
- [Join a chat](./management/join.md) — `POST /v1/chats/:dialogId/join`
- [Attach to a parent chat](./management/parent.md) — `PUT /v1/chats/:dialogId/parent`
- [Detach from the parent chat](./management/parent-delete.md) — `DELETE /v1/chats/:dialogId/parent`
- [Delete a chat](./management/delete.md) — `DELETE /v1/chats/:dialogId`
- [Clear chat history](./management/history-clear.md) — `POST /v1/chats/:dialogId/history/clear`

**Deleting a chat is irreversible:** the chat disappears for all members together with its messages and files. If you only want to stop being a member, leave the chat.

## Typical scenario

Leaving a chat does not take ownership away from the owner: after leaving, they remain the owner. To leave for good, transfer ownership first, then leave the chat.

1. [Transfer chat ownership](/docs/chats/management/owner) to another member.
2. [Leave the chat](/docs/chats/management/leave).

## See also

- [Chats and messages](/docs/chats)
- [Members](/docs/chats/members)