telegram api method · layer 229 · #3514b3de

channels.updateUsername

usable by users

Change or remove the username of a supergroup/channel

definition

channels.updateUsername#3514b3de channel:InputChannel username:string = Bool;

name	type	description
`channel`	InputChannel	Channel
`username`	string	New username, pass an empty string to remove the username

code	error	description
400	BUSINESS_CONNECTION_NOT_ALLOWED	This 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.
400	CHANNEL_INVALID	The provided channel is invalid.
400	CHANNEL_PRIVATE	You haven't joined this channel/supergroup.
400	CHANNELS_ADMIN_PUBLIC_TOO_MUCH	You're admin of too many public channels, make some channels private to change the username of this channel.
400	CHAT_ADMIN_REQUIRED	You must be an admin in this chat to do this.
400	CHAT_NOT_MODIFIED	No changes were made to chat information because the new information you passed is identical to the current information.
400	USERNAME_INVALID	The provided username is not valid.
400	USERNAME_NOT_MODIFIED	The username was not modified.
400	USERNAME_OCCUPIED	The provided username is already occupied.
400	USERNAME_PURCHASE_AVAILABLE	The specified username can be purchased on https://fragment.com.
401	AUTH_KEY_UNREGISTERED	The specified authorization key is not registered in the system (for example, a PFS temporary key has expired).
403	CHAT_ADMIN_REQUIRED	You must be an admin in this chat to do this.
403	CHAT_WRITE_FORBIDDEN	You can't write in this chat.

present in layers 46–229

id	layers
#3514b3de	46–229