[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-chats\u002Fmanagement\u002Fowner":3,"docs-tabs-chats\u002Fmanagement\u002Fowner":6},{"content":4,"lastmod":5},"\n## Передать владение чатом\n\n`POST \u002Fv1\u002Fchats\u002F:chatId\u002Fowner`\n\nПередаёт права владельца группового чата другому участнику. Новый владелец должен уже состоять в чате.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `chatId` (path) | number | да | ID чата (положительное целое) |\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| `userId` | number | да | ID пользователя, которому передаётся владение. Пользователь должен быть участником чата. Список участников: `GET \u002Fv1\u002Fchats\u002F:chatId\u002Fusers` |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002F456\u002Fowner \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{ \"userId\": 42 }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002F456\u002Fowner \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{ \"userId\": 42 }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002F456\u002Fowner', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({ userId: 42 }),\n})\n\nconst { success, data } = await res.json()\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002F456\u002Fowner', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({ userId: 42 }),\n})\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | boolean | `true` при успешной передаче владения |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": true\n}\n```\n\n## Пример ответа при ошибке\n\n422 — нарушено условие передачи владения:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"Change owner can only owner and user must be member in chat\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `MISSING_PARAMS` | Поле `userId` отсутствует или не является положительным целым числом |\n| 422 | `BITRIX_ERROR` | Передать владение может только текущий владелец, новый владелец должен быть участником чата |\n| 502 | `BITRIX_UNAVAILABLE` | Битрикс24 недоступен или вернул ошибку сервера |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `im` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\nЕсли нужный участник ещё не состоит в чате, добавьте его через [`POST \u002Fv1\u002Fchats\u002F:chatId\u002Fusers`](\u002Fdocs\u002Fchats\u002Fmembers\u002Fadd) перед вызовом этого эндпоинта.\n\n**Выход владельца из чата.** Создатель чата остаётся владельцем даже после вызова [`POST \u002Fv1\u002Fchats\u002F:chatId\u002Fleave`](\u002Fdocs\u002Fchats\u002Fmanagement\u002Fleave) — выход не снимает статус владельца. Чтобы покинуть чат полностью: сначала передайте владение другому участнику этим эндпоинтом, затем вызовите выход.\n\n## Смотрите также\n\n- [Покинуть чат](\u002Fdocs\u002Fchats\u002Fmanagement\u002Fleave)\n- [Добавить участников](\u002Fdocs\u002Fchats\u002Fmembers\u002Fadd)\n- [Управление чатами](\u002Fdocs\u002Fchats\u002Fmanagement)\n","2026-06-16",{}]