channels.checkUsername

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

func (c *Client) ChannelsCheckUsername(ctx context.Context, request *ChannelsCheckUsernameRequest) (bool, error)

Calling this method

client.Run(ctx, func(ctx context.Context) error {
	api := client.API()
	
	res, err := api.ChannelsCheckUsername(ctx, &tg.ChannelsCheckUsernameRequest{
		// see Parameters
	})
	if err != nil {
		return err
	}
	_ = res // bool
	return nil
})

Parameters

Name	Type	Required	Description
Channel	InputChannelClass	yes	The channel/supergroup that will assigned the specified username
Username	string	yes	The username to check

Returns

bool

Possible errors

Code	Type	Description
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	CHANNEL_INVALID	The provided channel is invalid.
400	CHANNEL_PRIVATE	You haven't joined this channel/supergroup.
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.

References

• Official documentation
• Generated Go reference
• TL definition: channels.checkUsername#10e6bd2c