telegram api method · layer 229 · #96e6cd81

channels.editBanned

usable by users and bots

Ban/unban/kick a user in a supergroup/channel.

definition

channels.editBanned#96e6cd81 channel:InputChannel participant:InputPeer banned_rights:ChatBannedRights = Updates;

parameters

nametypedescription
channelInputChannelThe supergroup/channel.
participantInputPeerParticipant to ban
banned_rightsChatBannedRightsThe banned rights

returns

Updates

errors (15)

codeerrordescription
400BUSINESS_CONNECTION_NOT_ALLOWEDThis method was invoked over a business connection using invokeWithBusinessConnection, but either (1) we're a user, and users cannot invoke methods over a business connection; (2) we're a bot, but business mode was disabled in @botfather or (3); we're a bot, but this method cannot be invoked over a business connection.
400CHANNEL_INVALIDThe provided channel is invalid.
400CHANNEL_PRIVATEYou haven't joined this channel/supergroup.
400CHAT_ADMIN_REQUIREDYou must be an admin in this chat to do this.
400INPUT_USER_DEACTIVATEDThe specified user was deleted.
400MSG_ID_INVALIDInvalid message ID provided.
400PARTICIPANT_ID_INVALIDThe specified participant ID is invalid.
400PEER_ID_INVALIDThe provided peer id is invalid.
400USER_ADMIN_INVALIDYou're not an admin.
400USER_ID_INVALIDThe provided user ID is invalid.
401AUTH_KEY_UNREGISTEREDThe specified authorization key is not registered in the system (for example, a PFS temporary key has expired).
403CHAT_ADMIN_REQUIREDYou must be an admin in this chat to do this.
403CHAT_WRITE_FORBIDDENYou can't write in this chat.
406BANNED_RIGHTS_INVALIDYou provided some invalid flags in the banned rights.
406CHANNEL_PRIVATEYou haven't joined this channel/supergroup.

history

present in layers 68–229 · constructor id changed 2×

idlayers
#bfd915cd68–92
#7279691293–125
#96e6cd81126–229