Telegram Bot API

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 administrator rights. Pass False for all boolean parameters to demote a user. Returns True on success.

post/promoteChatMember

Request

  • Base URL: https://api.telegram.org/bot<bot_token>
  • URL: https://api.telegram.org/bot<bot_token>/promoteChatMember
  • Auth: none declared

Request body

user_idinteger required

Unique identifier of the target user

is_anonymousboolean

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

can_manage_chatboolean

Pass True if the administrator can access the chat event log, get boost list, see hidden supergroup and channel members, report spam messages, ignore slow mode, and send messages to the chat without paying Telegram Stars. Implied by any other administrator privilege.

can_delete_messagesboolean

Pass True if the administrator can delete messages of other users

can_manage_video_chatsboolean

Pass True if the administrator can manage video chats

can_restrict_membersboolean

Pass True if the administrator can restrict, ban or unban chat members, or access supergroup statistics. For backward compatibility, defaults to True for promotions of channel administrators.

can_promote_membersboolean

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

can_change_infoboolean

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

can_invite_usersboolean

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

can_post_storiesboolean

Pass True if the administrator can post stories to the chat

can_edit_storiesboolean

Pass True if the administrator can edit stories posted by other users, post stories to the chat page, pin chat stories, and access the chat's story archive

can_delete_storiesboolean

Pass True if the administrator can delete stories posted by other users

can_post_messagesboolean

Pass True if the administrator can post messages in the channel, approve suggested posts, or access channel statistics; for channels only

can_edit_messagesboolean

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

can_pin_messagesboolean

Pass True if the administrator can pin messages; for supergroups only

can_manage_topicsboolean

Pass True if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only

can_manage_direct_messagesboolean

Pass True if the administrator can manage direct messages within the channel and decline suggested posts; for channels only

can_manage_tagsboolean

Pass True if the administrator can edit the tags of regular members; for groups and supergroups only

Response

Telegram API response

oktrue required
resulttrue required

Changes

No recorded changes to this operation across all 3 revisions of this API.