messages.deleteHistory

messages.deleteHistory

No description provided by the pinned schema.

Signature

messages.deleteHistory#b08f922a flags:# just_clear:flags.0?true revoke:flags.1?true peer:InputPeer max_id:int min_date:flags.2?int max_date:flags.3?int = messages.AffectedHistory;

Result type

messages.AffectedHistory

Parameters

Name	Type	Flag	Default	Description
flags	#	flag word	—	No description provided by the pinned schema.
just_clear	flags.0?true	flags.0	—	No description provided by the pinned schema.
revoke	flags.1?true	flags.1	—	No description provided by the pinned schema.
peer	InputPeer	—	—	No description provided by the pinned schema.
max_id	int	—	—	No description provided by the pinned schema.
min_date	flags.2?int	flags.2	—	No description provided by the pinned schema.
max_date	flags.3?int	flags.3	—	No description provided by the pinned schema.

Flags

Parameter	Bit	Meaning
just_clear	0	Controlled by flags; present when this bit is set.
revoke	1	Controlled by flags; present when this bit is set.
min_date	2	Controlled by flags; present when this bit is set.
max_date	3	Controlled by flags; present when this bit is set.

Python binding

from miniproto.raw.functions import MessagesDeleteHistory

Public access: miniproto.raw.functions.MessagesDeleteHistory.

Safe usage shape

from miniproto.raw.functions import MessagesDeleteHistory

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

Result family

messages.AffectedHistory

RPC errors

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_PRIVATE	You haven’t joined this channel/supergroup.
400	CHAT_ADMIN_REQUIRED	You must be an admin in this chat to do this.
400	CHAT_ID_INVALID	The provided chat id is invalid.
400	CHAT_REVOKE_DATE_UNSUPPORTED	min_date and max_date are not available for using with non-user peers.
400	MAX_DATE_INVALID	The specified maximum date is invalid.
400	MESSAGE_ID_INVALID	The provided message id is invalid.
400	MIN_DATE_INVALID	The specified minimum date is invalid.
400	MSG_ID_INVALID	Invalid message ID provided.
400	PEER_ID_INVALID	The provided peer id is invalid.
401	AUTH_KEY_UNREGISTERED	The specified authorization key is not registered in the system (for example, a PFS temporary key has expired).

Accepted types

InputPeer Known selected constructors: inputPeerChannel, inputPeerChannelFromMessage, inputPeerChat, inputPeerEmpty, inputPeerSelf, inputPeerUser, inputPeerUserFromMessage

Returned types

messages.AffectedHistory Known selected constructors: messages.affectedHistory

Related methods

account.disablePeerConnectedBot, account.getPaidMessagesRevenue, account.reportPeer, account.reportProfilePhoto, account.saveAutoSaveSettings, account.toggleConnectedBotPaused, account.toggleNoPaidMessagesException, bots.setCustomVerification, channels.deleteParticipantHistory, channels.editBanned, channels.getParticipant, channels.getSendAs, channels.reportSpam, channels.searchPosts, chatlists.editExportedInvite, chatlists.exportChatlistInvite, chatlists.joinChatlistInvite, chatlists.joinChatlistUpdates, chatlists.leaveChatlist, communities.create, communities.getParticipantJoinedChats, communities.toggleParticipantBanned, communities.togglePeerLink, communities.togglePeerLinkRequestApproval, contacts.block, contacts.resetTopPeerRating, contacts.setBlocked, contacts.unblock, ephemeral.deleteMessage, ephemeral.editMessage, ephemeral.getCallbackAnswer, ephemeral.reportMessage, ephemeral.sendMessage, help.dismissSuggestion, help.hidePromoData, messages.acceptUrlAuth, messages.addPollAnswer, messages.appendTodoList, messages.checkHistoryImportPeer, messages.createForumTopic, messages.deleteExportedChatInvite, messages.deleteFactCheck, messages.deleteParticipantReaction, messages.deleteParticipantReactions, messages.deletePollAnswer, messages.deleteRevokedExportedChatInvites, messages.deleteSavedHistory, messages.deleteScheduledMessages, messages.deleteTopicHistory, messages.editChatAbout, messages.editChatCreator, messages.editChatDefaultBannedRights, messages.editChatParticipantRank, messages.editExportedChatInvite, messages.editFactCheck, messages.editForumTopic, messages.editMessage, messages.exportChatInvite, messages.forwardMessages, messages.getAdminsWithInvites, messages.getBotCallbackAnswer, messages.getChatInviteImporters, messages.getDialogUnreadMarks, messages.getDialogs, messages.getDiscussionMessage, messages.getExportedChatInvite, messages.getExportedChatInvites, messages.getExtendedMedia, messages.getFactCheck, messages.getForumTopics, messages.getForumTopicsByID, messages.getFutureChatCreatorAfterLeave, messages.getGameHighScores, messages.getHistory, messages.getInlineBotResults, messages.getMessageEditData, messages.getMessageReactionsList, messages.getMessageReadParticipants, messages.getMessagesReactions, messages.getMessagesViews, messages.getOnlines, messages.getOutboxReadDate, messages.getPeerSettings, messages.getPollResults, messages.getPollVotes, messages.getRecentLocations, messages.getReplies, messages.getRichMessage, messages.getSavedDialogs, messages.getSavedDialogsByID, messages.getSavedHistory, messages.getSavedReactionTags, messages.getScheduledHistory, messages.getScheduledMessages, messages.getSearchCounters, messages.getSearchResultsCalendar, messages.getSearchResultsPositions, messages.getSponsoredMessages, messages.getUnreadMentions, messages.getUnreadPollVotes, messages.getUnreadReactions, messages.hideAllChatJoinRequests, messages.hideChatJoinRequest, messages.hidePeerSettingsBar, messages.initHistoryImport, messages.markDialogUnread, messages.prolongWebView, messages.rateTranscribedAudio, messages.readDiscussion, messages.readHistory, messages.readMentions, messages.readPollVotes, messages.readReactions, messages.readSavedHistory, messages.reorderPinnedForumTopics, messages.report, messages.reportMessagesDelivery, messages.reportReaction, messages.reportReadMetrics, messages.reportSpam, messages.requestAppWebView, messages.requestMainWebView, messages.requestUrlAuth, messages.requestWebView, messages.saveDefaultSendAs, messages.saveDraft, messages.search, messages.searchGlobal, messages.sendBotRequestedPeer, messages.sendInlineBotResult, messages.sendMedia, messages.sendMessage, messages.sendMultiMedia, messages.sendPaidReaction, messages.sendQuickReplyMessages, messages.sendReaction, messages.sendScheduledMessages, messages.sendScreenshotNotification, messages.sendVote, messages.setChatAvailableReactions, messages.setChatTheme, messages.setChatWallPaper, messages.setGameScore, messages.setHistoryTTL, messages.setTyping, messages.startBot, messages.startHistoryImport, messages.summarizeText, messages.toggleNoForwards, messages.togglePaidReactionPrivacy, messages.togglePeerTranslations, messages.toggleSuggestedPostApproval, messages.toggleTodoCompleted, messages.transcribeAudio, messages.translateRichMessage, messages.translateText, messages.unpinAllMessages, messages.updatePinnedForumTopic, messages.updatePinnedMessage, messages.uploadImportedMedia, messages.uploadMedia, payments.changeStarsSubscription, payments.connectStarRefBot, payments.createStarGiftCollection, payments.deleteStarGiftCollection, payments.editConnectedStarRefBot, payments.fulfillStarsSubscription, payments.getConnectedStarRefBot, payments.getConnectedStarRefBots, payments.getGiveawayInfo, payments.getPaymentReceipt, payments.getPremiumGiftCodeOptions, payments.getSavedStarGifts, payments.getStarGiftCollections, payments.getStarsRevenueAdsAccountUrl, payments.getStarsRevenueStats, payments.getStarsRevenueWithdrawalUrl, payments.getStarsStatus, payments.getStarsSubscriptions, payments.getStarsTransactions, payments.getStarsTransactionsByID, payments.getSuggestedStarRefBots, payments.launchPrepaidGiveaway, payments.reorderStarGiftCollections, payments.sendStarGiftOffer, payments.toggleChatStarGiftNotifications, payments.toggleStarGiftsPinnedToTop, payments.transferStarGift, payments.updateStarGiftCollection, phone.createGroupCall, phone.deleteGroupCallParticipantMessages, phone.editGroupCallParticipant, phone.getGroupCallJoinAs, phone.getGroupCallStreamRtmpUrl, phone.getGroupParticipants, phone.joinGroupCall, phone.saveDefaultGroupCallJoinAs, phone.saveDefaultSendAs, phone.sendGroupCallMessage, premium.applyBoost, premium.getBoostsList, premium.getBoostsStatus, premium.getUserBoosts, stats.getPollStats, stats.getStoryPublicForwards, stats.getStoryStats, stories.canSendStory, stories.createAlbum, stories.deleteAlbum, stories.deleteStories, stories.editStory, stories.exportStoryLink, stories.getAlbumStories, stories.getAlbums, stories.getPeerMaxIDs, stories.getPeerStories, stories.getPinnedStories, stories.getStoriesArchive, stories.getStoriesByID, stories.getStoriesViews, stories.getStoryReactionsList, stories.getStoryViewsList, stories.incrementStoryViews, stories.readStories, stories.reorderAlbums, stories.report, stories.searchPosts, stories.sendReaction, stories.sendStory, stories.startLive, stories.togglePeerStoriesHidden, stories.togglePinned, stories.togglePinnedToTop, stories.updateAlbum

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