promoteChatMember

Returns boolean ↗

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.

Required: chat_id, user_id · Optional: 17 parameters

Try it

Token saved Change

Bot Token

Save

chat_id

Detect ...

user_id

optional (17)

is_anonymous — true false

can_manage_chat — true false

can_delete_messages — true false

can_manage_video_chats — true false

can_restrict_members — true false

can_promote_members — true false

can_change_info — true false

can_invite_users — true false

can_post_stories — true false

can_edit_stories — true false

can_delete_stories — true false

can_post_messages — true false

can_edit_messages — true false

can_pin_messages — true false

can_manage_topics — true false

can_manage_direct_messages — true false

can_manage_tags — true false

Run Running... Reset

Response

TypeScript example · @effect-ak/tg-bot-client

import { makeTgBotClient } from "@effect-ak/tg-bot-client"

const client = makeTgBotClient({ bot_token: "YOUR_BOT_TOKEN" })

const result = await client.execute("promote_chat_member", {
  chat_id: "YOUR_CHAT_ID",
  user_id: 0
})

Parameters

chat_id number | string Required
Unique identifier for the target chat or username of the target channel (in the format @channelusername).

user_id number Required
Unique identifier of the target user.

is_anonymous boolean
Pass True if the administrator’s presence in the chat is hidden.

can_manage_chat boolean
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_messages boolean
Pass True if the administrator can delete messages of other users.

can_manage_video_chats boolean
Pass True if the administrator can manage video chats.

can_restrict_members boolean
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_members boolean
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_info boolean
Pass True if the administrator can change chat title, photo and other settings.

can_invite_users boolean
Pass True if the administrator can invite new users to the chat.

can_post_stories boolean
Pass True if the administrator can post stories to the chat.

can_edit_stories boolean
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_stories boolean
Pass True if the administrator can delete stories posted by other users.

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

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

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

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

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

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