bots.toggleUsername

bots.toggleUsername

No description provided by the pinned schema.

Signature

bots.toggleUsername#053ca973 bot:InputUser username:string active:Bool = Bool;

Result type

Bool

Parameters

Name	Type	Flag	Default	Description
bot	InputUser	—	—	No description provided by the pinned schema.
username	string	—	—	No description provided by the pinned schema.
active	Bool	—	—	No description provided by the pinned schema.

Python binding

from miniproto.raw.functions import BotsToggleUsername

Public access: miniproto.raw.functions.BotsToggleUsername.

Safe usage shape

from miniproto.raw.functions import BotsToggleUsername

# Naming the raw request class is local only; it performs no I/O or network request.
request_type = BotsToggleUsername

Result family

Bool

RPC errors

Code	Error	Description
400	BOT_INVALID	This is not a valid bot.
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	USERNAME_NOT_MODIFIED	The username was not modified.
401	AUTH_KEY_UNREGISTERED	The specified authorization key is not registered in the system (for example, a PFS temporary key has expired).

Accepted types

Bool, InputUser Known selected constructors: boolFalse, boolTrue, inputUser, inputUserEmpty, inputUserFromMessage, inputUserSelf

Returned types

Bool Known selected constructors: boolFalse, boolTrue

Related methods

account.acceptAuthorization, account.cancelPasswordEmail, account.changeAuthorizationSettings, account.checkUsername, account.clearRecentEmojiStatuses, account.confirmBotConnection, account.confirmPasswordEmail, account.confirmPhone, account.declinePasswordReset, account.deleteAccount, account.deleteAutoSaveExceptions, account.deleteBusinessChatLink, account.deletePasskey, account.deleteSecureValue, account.disablePeerConnectedBot, account.finishTakeoutSession, account.getContactSignUpNotification, account.getPaidMessagesRevenue, account.installTheme, account.installWallPaper, account.invalidateSignInCodes, account.registerDevice, account.reorderUsernames, account.reportPeer, account.reportProfilePhoto, account.resendPasswordEmail, account.resetAuthorization, account.resetNotifySettings, account.resetWallPapers, account.resetWebAuthorization, account.resetWebAuthorizations, account.saveAutoDownloadSettings, account.saveAutoSaveSettings, account.saveMusic, account.saveRingtone, account.saveTheme, account.saveWallPaper, account.setAccountTTL, account.setAuthorizationTTL, account.setContactSignUpNotification, account.setContentSettings, account.setMainProfileTab, account.toggleConnectedBotPaused, account.toggleNoPaidMessagesException, account.toggleSponsoredMessages, account.toggleUsername, account.toggleWebBrowserSettingsException, account.unregisterDevice, account.updateBirthday, account.updateBusinessAwayMessage, account.updateBusinessGreetingMessage, account.updateBusinessIntro, account.updateBusinessLocation, account.updateBusinessWorkHours, account.updateColor, account.updateConnectedBot, account.updateDeviceLocked, account.updateEmojiStatus, account.updateNotifySettings, account.updatePasswordSettings, account.updatePersonalChannel, account.updateStatus, account.verifyPhone, aicompose.deleteTone, aicompose.saveTone, aicompose.updateTone, auth.bindTempAuthKey, auth.cancelCode, auth.checkRecoveryPassword, auth.dropTempAuthKeys, auth.reportMissingCode, auth.requestFirebaseSms, auth.resetAuthorizations, bots.addPreviewMedia, bots.allowSendMessage, bots.answerWebhookJSONQuery, bots.canSendMessage, bots.checkDownloadFileParams, bots.checkUsername, bots.createBot, bots.deletePreviewMedia, bots.editAccessSettings, bots.editPreviewMedia, bots.exportBotToken, bots.getAccessSettings, bots.getBotInfo, bots.getBotMenuButton, bots.getBotRecommendations, bots.getPreviewInfo, bots.getPreviewMedias, bots.getRequestedWebViewButton, bots.invokeWebViewCustomMethod, bots.reorderPreviewMedias, bots.reorderUsernames, bots.requestWebViewButton, bots.resetBotCommands, bots.setBotBroadcastDefaultAdminRights, bots.setBotCommands, bots.setBotGroupDefaultAdminRights, bots.setBotInfo, bots.setBotMenuButton, bots.setCustomVerification, bots.setJoinChatResults, bots.toggleUserEmojiStatusPermission, bots.updateStarRefProgram, bots.updateUserEmojiStatus, channels.checkUsername, channels.deactivateAllUsernames, channels.editAdmin, channels.editLocation, channels.getAdminLog, channels.inviteToChannel, channels.readHistory, channels.readMessageContents, channels.reorderUsernames, channels.reportAntiSpamFalsePositive, channels.reportSpam, channels.restrictSponsoredMessages, channels.setDiscussionGroup, channels.setEmojiStickers, channels.setMainProfileTab, channels.setStickers, channels.toggleAntiSpam, channels.toggleAutotranslation, channels.toggleForum, channels.toggleJoinRequest, channels.toggleJoinToSend, channels.toggleParticipantsHidden, channels.togglePreHistoryHidden, channels.toggleUsername, channels.toggleViewForumAsMessages, channels.updateUsername, chatlists.deleteExportedInvite, chatlists.hideChatlistUpdates, communities.toggleAllPeerLinkRequestApproval, communities.toggleParticipantBanned, communities.togglePeerLink, communities.togglePeerLinkRequestApproval, contacts.acceptContact, contacts.addContact, contacts.block, contacts.deleteByPhones, contacts.deleteContacts, contacts.editCloseFriends, contacts.resetSaved, contacts.resetTopPeerRating, contacts.setBlocked, contacts.toggleTopPeers, contacts.unblock, contacts.updateContactNote, ephemeral.deleteMessage, ephemeral.editMessage, ephemeral.sendMessage, help.acceptTermsOfService, help.dismissSuggestion, help.editUserInfo, help.getUserInfo, help.hidePromoData, help.saveAppLog, help.setBotUpdatesStatus, messages.addChatUser, messages.checkQuickReplyShortcut, messages.checkUrlAuthMatchCode, messages.clearAllDrafts, messages.clearRecentReactions, messages.clearRecentStickers, messages.clickSponsoredMessage, messages.createChat, messages.declineUrlAuth, messages.deleteChat, messages.deleteChatUser, messages.deleteExportedChatInvite, messages.deleteParticipantReactions, messages.deleteQuickReplyShortcut, messages.deleteRevokedExportedChatInvites, messages.discardEncryption, messages.editChatAbout, messages.editChatAdmin, messages.editChatCreator, messages.editExportedChatInvite, messages.editForumTopic, messages.editInlineBotMessage, messages.editQuickReplyShortcut, messages.faveSticker, messages.getAttachMenuBot, messages.getChatInviteImporters, messages.getCommonChats, messages.getExportedChatInvites, messages.getGameHighScores, messages.getInlineBotResults, messages.getInlineGameHighScores, messages.getMessagesViews, messages.getPersonalChannelHistory, messages.getPreparedInlineMessage, messages.hideChatJoinRequest, messages.hidePeerSettingsBar, messages.installStickerSet, messages.markDialogUnread, messages.prolongWebView, messages.rateTranscribedAudio, messages.readDiscussion, messages.readEncryptedHistory, messages.readFeaturedStickers, messages.readSavedHistory, messages.reorderPinnedDialogs, messages.reorderPinnedSavedDialogs, messages.reorderQuickReplies, messages.reorderStickerSets, messages.reportEncryptedSpam, messages.reportMessagesDelivery, messages.reportMusicListen, messages.reportReaction, messages.reportReadMetrics, messages.reportSpam, messages.requestEncryption, messages.requestMainWebView, messages.requestSimpleWebView, messages.requestWebView, messages.saveDefaultSendAs, messages.saveDraft, messages.saveGif, messages.savePreparedInlineMessage, messages.saveRecentSticker, messages.sendWebViewData, messages.setBotCallbackAnswer, messages.setBotPrecheckoutResults, messages.setBotShippingResults, messages.setChatAvailableReactions, messages.setDefaultHistoryTTL, messages.setDefaultReaction, messages.setEncryptedTyping, messages.setGameScore, messages.setInlineBotResults, messages.setInlineGameScore, messages.setTyping, messages.startBot, messages.startHistoryImport, messages.toggleBotInAttachMenu, messages.toggleDialogFilterTags, messages.toggleDialogPin, messages.toggleNoForwards, messages.togglePaidReactionPrivacy, messages.togglePeerTranslations, messages.toggleSavedDialogPin, messages.toggleStickerSets, messages.uninstallStickerSet, messages.updateDialogFilter, messages.updateDialogFiltersOrder, messages.updatePinnedForumTopic, messages.updateSavedReactionTag, messages.viewSponsoredMessage, payments.botCancelStarsSubscription, payments.canPurchaseStore, payments.changeStarsSubscription, payments.clearSavedInfo, payments.connectStarRefBot, payments.convertStarGift, payments.deleteStarGiftCollection, payments.fulfillStarsSubscription, payments.getConnectedStarRefBot, payments.getStarsGiftOptions, payments.refundStarsCharge, payments.reorderStarGiftCollections, payments.saveStarGift, payments.toggleChatStarGiftNotifications, payments.toggleStarGiftsPinnedToTop, phone.editGroupCallParticipant, phone.getGroupCallStreamRtmpUrl, phone.inviteConferenceCallParticipant, phone.inviteToGroupCall, phone.receivedCall, phone.requestCall, phone.saveCallDebug, phone.saveCallLog, phone.saveDefaultGroupCallJoinAs, phone.saveDefaultSendAs, phone.sendGroupCallEncryptedMessage, phone.sendSignalingData, phone.toggleGroupCallRecord, phone.toggleGroupCallSettings, phone.toggleGroupCallStartSubscription, photos.getUserPhotos, photos.updateProfilePhoto, photos.uploadContactProfilePhoto, photos.uploadProfilePhoto, premium.getUserBoosts, smsjobs.finishJob, smsjobs.join, smsjobs.leave, smsjobs.updateSettings, stickers.checkShortName, stickers.createStickerSet, stickers.deleteStickerSet, stories.deleteAlbum, stories.incrementStoryViews, stories.reorderAlbums, stories.startLive, stories.toggleAllStoriesHidden, stories.togglePeerStoriesHidden, stories.togglePinned, stories.togglePinnedToTop, upload.saveBigFilePart, upload.saveFilePart, users.getFullUser, users.getRequirementsToContact, users.getSavedMusic, users.getSavedMusicByID, users.getUsers, users.setSecureValueErrors, users.suggestBirthday

Availability evidence

• user only

Provenance

• layer: 228
• structural source: tdlib
• canonical schema: https://raw.githubusercontent.com/tdlib/td/refs/heads/master/td/generate/scheme/telegram_api.tl
• prose merge precedence: TDLib → Telegram Desktop → Core JSON
• source note: Canonical structure is the pinned TDLib telegram_api.tl; Layer 228 comes only from the matching Telegram Desktop end-of-file marker; core.telegram.org inputs enrich documentation and RPC error metadata without overriding structure.

Source-diff notes

• tdlib_vs_core: changed_count=68; core_only_count=1; overlap_count=2302; tdlib_only_count=158
• tdlib_vs_tdesktop: changed_count=0; overlap_count=2448; tdesktop_only=null; tdlib_only=accessPointRule, ephemeral.editMessage, help.configSimple, inputPeerPhotoFileLocationLegacy, inputStickerSetThumbLegacy, invokeWithApnsSecretPrefix, invokeWithBusinessConnectionPrefix, invokeWithGooglePlayIntegrityPrefix, invokeWithReCaptchaPrefix, ipPort, ipPortSecret, updateEphemeralBotCallbackQuery