mirror of https://github.com/aiogram/aiogram.git synced 2025-12-12 02:03:04 +00:00

Alex Root Junior 6be0b36305

* AIOG-T-20 Bot API 4.8

* AIOG-T-20 Update aliases

* AIOG-T-20 Add parse mode passing in sendPoll method

* AIOG-T-20 Small changes in docs

* AIOG-T-20 Revert overriding remove keyboard default value and add tests

* AIOG-T-20 Bot API 4.8

2020-05-02 23:01:32 +03:00

2.5 KiB

Raw Blame History

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

Official documentation

2.5 KiB Raw Blame History