promote_chat_member()

Client.promote_chat_member()

Promote or demote a user in a supergroup or a channel.

You 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.

Parameters

• chat_id (int | str) – Unique identifier (int) or username (str) of the target chat.

• user_id (int | str) – Unique identifier (int) or username (str) of the target user. For a contact that exists in your Telegram address book you can use his phone number (str).

• is_anonymous (bool, optional) – Pass True, if the administrator’s presence in the chat is hidden.

• can_change_info (bool, optional) – Pass True, if the administrator can change chat title, photo and other settings.

• can_post_messages (bool, optional) – Pass True, if the administrator can create channel posts, channels only.

• can_edit_messages (bool, optional) – Pass True, if the administrator can edit messages of other users and can pin messages, channels only.

• can_delete_messages (bool, optional) – Pass True, if the administrator can delete messages of other users.

• can_restrict_members (bool, optional) – Pass True, if the administrator can restrict, ban or unban chat members.

• can_invite_users (bool, optional) – Pass True, if the administrator can invite new users to the chat.

• can_pin_messages (bool, optional) – Pass True, if the administrator can pin messages, supergroups only.

• can_promote_members (bool, optional) – Pass True, if the administrator can add new administrators with a subset of his own privileges or demote administrators that he has promoted, directly or indirectly (promoted by administrators that were appointed by him).

Returns

bool – True on success.

Example

# Promote chat member to supergroup admin
app.promote_chat_member(chat_id, user_id)