promoteChatMember

Description

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.

Arguments

Name Type Description
chat_id Union[int, str] Unique identifier for the target chat or username of the target channel (in the format @channelusername)
user_id int Unique identifier of the target user
can_change_info Optional[bool] Optional. Pass True, if the administrator can change chat title, photo and other settings
can_post_messages Optional[bool] Optional. Pass True, if the administrator can create channel posts, channels only
can_edit_messages Optional[bool] Optional. Pass True, if the administrator can edit messages of other users and can pin messages, channels only
can_delete_messages Optional[bool] Optional. Pass True, if the administrator can delete messages of other users
can_invite_users Optional[bool] Optional. Pass True, if the administrator can invite new users to the chat
can_restrict_members Optional[bool] Optional. Pass True, if the administrator can restrict, ban or unban chat members
can_pin_messages Optional[bool] Optional. Pass True, if the administrator can pin messages, supergroups only
can_promote_members Optional[bool] Optional. 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)

Response

Type: bool

Description: Returns True on success.

Usage

As bot method

result: bool = await bot.promote_chat_member(...)

Method as object

Imports:

  • from aiogram.methods import PromoteChatMember
  • from aiogram.api.methods import PromoteChatMember
  • from aiogram.api.methods.promote_chat_member import PromoteChatMember

In handlers with current bot

result: bool = await PromoteChatMember(...)

With specific bot

result: bool = await bot(PromoteChatMember(...))

As reply into Webhook in handler

return PromoteChatMember(...)