promoteChatMember

suspend fun TelegramBotApiClient.promoteChatMember(requestBody: PromoteChatMemberRequest): TelegramResponse<Boolean>
Content copied to clipboard

Use this method to promote or demote a user in a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights. Pass False for all boolean parameters to demote a user. Returns True on success.

suspend fun TelegramBotApiClient.promoteChatMember(chatId: Int, userId: Int, isAnonymous: Boolean = false, canChangeInfo: Boolean = false, canPostMessages: Boolean = false, canEditMessages: Boolean = false, canDeleteMessages: Boolean = false, canInviteUsers: Boolean = false, canRestrictMembers: Boolean = false, canPinMessages: Boolean = false, canPromoteMembers: Boolean = false): TelegramResponse<Boolean>
Content copied to clipboard

Use this method to promote or demote a user in a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights. Pass False for all boolean parameters to demote a user. Returns True on success.

Parameters

chatId

Unique identifier for the target chat or username of the target channel (in the format @channelusername)

userId

Unique identifier of the target user

isAnonymous

Pass True, if the administrator's presence in the chat is hidden

canChangeInfo

Pass True, if the administrator can change chat title, photo and other settings

canPostMessages

Pass True, if the administrator can create channel posts, channels only

canEditMessages

Pass True, if the administrator can edit messages of other users and can pin messages, channels only

canDeleteMessages

Pass True, if the administrator can delete messages of other users

canInviteUsers

Pass True, if the administrator can invite new users to the chat

canRestrictMembers

Pass True, if the administrator can restrict, ban or unban chat members

canPinMessages

Pass True, if the administrator can pin messages, supergroups only

canPromoteMembers

Pass True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that he has promoted, directly or indirectly (promoted by administrators that were appointed by him)