Skip to main content

Удаление владельца группы

Метод и конечная точка​

POST /groups.removeOwner

Описание​

Лишает пользователя прав владельца приватной группы. Требует прав на управление владельцами группы.

Параметры​

Перечень параметров представлен в таблице.

НазваниеОбязательныйТип данныхОписание
roomIdнет*stringИдентификатор группы
roomNameнет*stringНазвание группы
userIdнет**stringИдентификатор пользователя
usernameнет**stringИмя пользователя

* Должен быть указан один из параметров: roomId или roomName.

** Должен быть указан один из параметров: userId или username.

Запрос​

curl -X 'POST' \
'https://im-<ENV>.<DEFAULT_DOMAIN>/api/v1/groups.removeOwner' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'X-User-Id: <USER_ID>' \
-H 'x-auth-token: <AUTH_TOKEN>' \
-d '{ \
"roomId": "<ROOM_ID>",
"userId": "<USER_ID_TO_REMOVE>"
}'

Где:

  • <ENV> — окружение, на котором выполняется запрос;
  • <DEFAULT_DOMAIN> — домен сервера Squadus;
  • <USER_ID> — идентификатор пользователя, от имени которого выполняется запрос;
  • <AUTH_TOKEN> — токен аутентификации пользователя;
  • <ROOM_ID> — идентификатор группы;
  • <USER_ID_TO_REMOVE> — идентификатор пользователя, которого нужно лишить прав владельца.

Ответ​

200 — Result of removing a owner — Владелец удален. Пример вывода:

{
"success": true
}