Меняет роль участника беседы или канала. Роль в чате с ролью в пространстве не связана: рядовой сотрудник может быть администратором чата, а повышение в пространстве роли в чатах не меняет.
Роль editor существует только в каналах. Себе роль сменить нельзя, как и тому, кто в чате не состоит, и владельцу чата: он всегда имеет права администратора чата. Повторная установка той же роли считается ошибкой, а не повтором.
Отказ приходит со статусом 400, а причину называет код: not_applicable — роль editor вне канала, self_update — своя роль, owner_protected — роль владельца чата, already_assigned — у участника уже эта роль, forbidden — эту роль вам менять нельзя. На сотрудника, который в чате не состоит, метод отвечает 404.
Параметры пути
id
integer, (int32)
*Идентификатор чата
Пример:
334user_id
integer, (int32)
*Идентификатор пользователя
Пример:
186Тело запроса
application/jsonrole
string
*Роль
Возможные значения
Пример:
adminОтвет
204No Content
There is no content to send for this request, but the headers may be useful.