telegram api method · layer 229 · #10e6bd2c

channels.checkUsername

usable by users

Check if a username is free and can be assigned to a channel/supergroup

definition

channels.checkUsername#10e6bd2c channel:InputChannel username:string = Bool;

name	type	description
`channel`	InputChannel	The channel/supergroup that will assigned the specified username
`username`	string	The username to check

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_ID_INVALID	The provided chat id is invalid.
400	MSG_ID_INVALID	Invalid message ID provided.
400	PEER_ID_INVALID	The provided peer id is invalid.
400	USERNAME_INVALID	The provided username is not valid.
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).

present in layers 46–229

id	layers
#10e6bd2c	46–229