stories.sendStory
stories.sendStory
Section titled “stories.sendStory”No description provided by the pinned schema.
Signature
Section titled “Signature”stories.sendStory#8f9e6898 flags:# pinned:flags.2?true noforwards:flags.4?true fwd_modified:flags.7?true peer:InputPeer media:InputMedia media_areas:flags.5?Vector<MediaArea> caption:flags.0?string entities:flags.1?Vector<MessageEntity> privacy_rules:Vector<InputPrivacyRule> random_id:long period:flags.3?int fwd_from_id:flags.6?InputPeer fwd_from_story:flags.6?int albums:flags.8?Vector<int> music:flags.9?InputDocument = Updates;Result type
Section titled “Result type”Updates
Parameters
Section titled “Parameters”| Name | Type | Flag | Default | Description |
|---|---|---|---|---|
| flags | # | flag word | — | No description provided by the pinned schema. |
| pinned | flags.2?true | flags.2 | — | No description provided by the pinned schema. |
| noforwards | flags.4?true | flags.4 | — | No description provided by the pinned schema. |
| fwd_modified | flags.7?true | flags.7 | — | No description provided by the pinned schema. |
| peer | InputPeer | — | — | No description provided by the pinned schema. |
| media | InputMedia | — | — | No description provided by the pinned schema. |
| media_areas | flags.5?Vector | flags.5 | — | No description provided by the pinned schema. |
| caption | flags.0?string | flags.0 | — | No description provided by the pinned schema. |
| entities | flags.1?Vector | flags.1 | — | No description provided by the pinned schema. |
| privacy_rules | Vector | — | — | No description provided by the pinned schema. |
| random_id | long | — | — | No description provided by the pinned schema. |
| period | flags.3?int | flags.3 | — | No description provided by the pinned schema. |
| fwd_from_id | flags.6?InputPeer | flags.6 | — | No description provided by the pinned schema. |
| fwd_from_story | flags.6?int | flags.6 | — | No description provided by the pinned schema. |
| albums | flags.8?Vector | flags.8 | — | No description provided by the pinned schema. |
| music | flags.9?InputDocument | flags.9 | — | No description provided by the pinned schema. |
| Parameter | Bit | Meaning |
|---|---|---|
| pinned | 2 | Controlled by flags; present when this bit is set. |
| noforwards | 4 | Controlled by flags; present when this bit is set. |
| fwd_modified | 7 | Controlled by flags; present when this bit is set. |
| media_areas | 5 | Controlled by flags; present when this bit is set. |
| caption | 0 | Controlled by flags; present when this bit is set. |
| entities | 1 | Controlled by flags; present when this bit is set. |
| period | 3 | Controlled by flags; present when this bit is set. |
| fwd_from_id | 6 | Controlled by flags; present when this bit is set. |
| fwd_from_story | 6 | Controlled by flags; present when this bit is set. |
| albums | 8 | Controlled by flags; present when this bit is set. |
| music | 9 | Controlled by flags; present when this bit is set. |
Python binding
Section titled “Python binding”from miniproto.raw.functions import StoriesSendStoryPublic access: miniproto.raw.functions.StoriesSendStory.
Safe usage shape
Section titled “Safe usage shape”from miniproto.raw.functions import StoriesSendStory
# Naming the raw request class is local only; it performs no I/O or network request.request_type = StoriesSendStoryResult family
Section titled “Result family”RPC errors
Section titled “RPC errors”| Code | Error | Description |
|---|---|---|
| 400 | BOOSTS_REQUIRED | The specified channel must first be boosted by its users in order to perform this action. |
| 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 | CHAT_ADMIN_REQUIRED | You must be an admin in this chat to do this. |
| 400 | IMAGE_PROCESS_FAILED | Failure while processing image. |
| 400 | MEDIA_CAPTION_TOO_LONG | The caption is too long. |
| 400 | MEDIA_EMPTY | The provided media object is invalid. |
| 400 | MEDIA_FILE_INVALID | The specified media file is invalid. |
| 400 | MEDIA_TYPE_INVALID | The specified media type cannot be used in stories. |
| 400 | MEDIA_VIDEO_STORY_MISSING | A non-story video cannot be repubblished as a story (emitted when trying to resend a non-story video as a story using inputDocument). |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. |
| 400 | PHOTO_INVALID_DIMENSIONS | The photo dimensions are invalid. |
| 400 | PREMIUM_ACCOUNT_REQUIRED | A premium account is required to execute this action. |
| 400 | REACTION_INVALID | The specified reaction is invalid. |
| 400 | STORIES_TOO_MUCH | You have hit the maximum active stories limit as specified by the story_expiring_limit_* client configuration parameters: you should buy a Premium subscription, delete an active story, or wait for the oldest story to expire. |
| 400 | STORY_PERIOD_INVALID | The specified story period is invalid for this account. |
| 400 | VENUE_ID_INVALID | The specified venue ID is invalid. |
| 400 | VIDEO_DURATION_INVALID | The duration of the specified video is invalid. |
| 401 | AUTH_KEY_UNREGISTERED | The specified authorization key is not registered in the system (for example, a PFS temporary key has expired). |
| 403 | BOT_ACCESS_FORBIDDEN | The specified method can be used over a business connection for some operations, but the specified query attempted an operation that is not allowed over a business connection. |
Accepted types
Section titled “Accepted types”InputDocument, InputMedia, InputPeer, InputPrivacyRule, MediaArea, MessageEntity
Known selected constructors: inputDocument, inputDocumentEmpty, inputMediaContact, inputMediaDice, inputMediaDocument, inputMediaDocumentExternal, inputMediaEmpty, inputMediaGame, inputMediaGeoLive, inputMediaGeoPoint, inputMediaInvoice, inputMediaPaidMedia, inputMediaPhoto, inputMediaPhotoExternal, inputMediaPoll, inputMediaStakeDice, inputMediaStory, inputMediaTodo, inputMediaUploadedDocument, inputMediaUploadedPhoto, inputMediaVenue, inputMediaWebPage, inputPeerChannel, inputPeerChannelFromMessage, inputPeerChat, inputPeerEmpty, inputPeerSelf, inputPeerUser, inputPeerUserFromMessage, inputPrivacyValueAllowAll, inputPrivacyValueAllowBots, inputPrivacyValueAllowChatParticipants, inputPrivacyValueAllowCloseFriends, inputPrivacyValueAllowContacts, inputPrivacyValueAllowPremium, inputPrivacyValueAllowUsers, inputPrivacyValueDisallowAll, inputPrivacyValueDisallowBots, inputPrivacyValueDisallowChatParticipants, inputPrivacyValueDisallowContacts, inputPrivacyValueDisallowUsers, inputMediaAreaChannelPost, inputMediaAreaVenue, mediaAreaChannelPost, mediaAreaGeoPoint, mediaAreaStarGift, mediaAreaSuggestedReaction, mediaAreaUrl, mediaAreaVenue, mediaAreaWeather, inputMessageEntityMentionName, messageEntityBankCard, messageEntityBlockquote, messageEntityBold, messageEntityBotCommand, messageEntityCashtag, messageEntityCode, messageEntityCustomEmoji, messageEntityDiffDelete, messageEntityDiffInsert, messageEntityDiffReplace, messageEntityEmail, messageEntityFormattedDate, messageEntityHashtag, messageEntityItalic, messageEntityMention, messageEntityMentionName, messageEntityPhone, messageEntityPre, messageEntitySpoiler, messageEntityStrike, messageEntityTextUrl, messageEntityUnderline, messageEntityUnknown, messageEntityUrl
Returned types
Section titled “Returned types”Updates
Known selected constructors: updateShort, updateShortChatMessage, updateShortMessage, updateShortSentMessage, updates, updatesCombined, updatesTooLong
Related methods
Section titled “Related methods”account.createTheme, account.disablePeerConnectedBot, account.getBotBusinessConnection, account.getNotifyExceptions, account.getPaidMessagesRevenue, account.reportPeer, account.reportProfilePhoto, account.saveAutoSaveSettings, account.saveMusic, account.saveRingtone, account.setPrivacy, account.toggleConnectedBotPaused, account.toggleNoPaidMessagesException, account.toggleWebBrowserSettingsException, account.updateConnectedBot, account.updateTheme, bots.addPreviewMedia, bots.allowSendMessage, bots.deletePreviewMedia, bots.editPreviewMedia, bots.reorderPreviewMedias, bots.setCustomVerification, channels.convertToGigagroup, channels.createChannel, channels.deleteChannel, channels.deleteHistory, channels.deleteParticipantHistory, channels.editAdmin, channels.editBanned, channels.editPhoto, channels.editTitle, channels.getParticipant, channels.getSendAs, channels.leaveChannel, channels.reportSpam, channels.restrictSponsoredMessages, channels.searchPosts, channels.setBoostsToUnblockRestrictions, channels.toggleAntiSpam, channels.toggleAutotranslation, channels.toggleForum, channels.toggleJoinRequest, channels.toggleJoinToSend, channels.toggleParticipantsHidden, channels.togglePreHistoryHidden, channels.toggleSignatures, channels.toggleSlowMode, channels.toggleViewForumAsMessages, channels.updateColor, channels.updateEmojiStatus, channels.updatePaidMessagesPrice, chatlists.editExportedInvite, chatlists.exportChatlistInvite, chatlists.joinChatlistInvite, chatlists.joinChatlistUpdates, chatlists.leaveChatlist, communities.create, communities.getParticipantJoinedChats, communities.toggleCommunityCollapsedInDialogs, communities.toggleParticipantBanned, communities.togglePeerLink, communities.togglePeerLinkRequestApproval, contacts.acceptContact, contacts.addContact, contacts.block, contacts.blockFromReplies, contacts.deleteContacts, contacts.getLocated, contacts.resetTopPeerRating, contacts.setBlocked, contacts.unblock, ephemeral.deleteMessage, ephemeral.editMessage, ephemeral.getCallbackAnswer, ephemeral.reportMessage, ephemeral.sendMessage, folders.editPeerFolders, help.dismissSuggestion, help.editUserInfo, help.hidePromoData, messages.acceptUrlAuth, messages.addPollAnswer, messages.appendTodoList, messages.checkHistoryImportPeer, messages.createForumTopic, messages.deleteChatUser, messages.deleteExportedChatInvite, messages.deleteFactCheck, messages.deleteHistory, messages.deleteParticipantReaction, messages.deleteParticipantReactions, messages.deletePollAnswer, messages.deleteQuickReplyMessages, messages.deleteRevokedExportedChatInvites, messages.deleteSavedHistory, messages.deleteScheduledMessages, messages.deleteTopicHistory, messages.editChatAbout, messages.editChatCreator, messages.editChatDefaultBannedRights, messages.editChatParticipantRank, messages.editChatPhoto, messages.editChatTitle, messages.editExportedChatInvite, messages.editFactCheck, messages.editForumTopic, messages.editInlineBotMessage, messages.editMessage, messages.exportChatInvite, messages.faveSticker, messages.forwardMessages, messages.getAdminsWithInvites, messages.getAllDrafts, 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.getPaidReactionPrivacy, 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.getWebPagePreview, messages.hideAllChatJoinRequests, messages.hideChatJoinRequest, messages.hidePeerSettingsBar, messages.initHistoryImport, messages.markDialogUnread, messages.migrateChat, messages.prolongWebView, messages.rateTranscribedAudio, messages.readDiscussion, messages.readHistory, messages.readMentions, messages.readPollVotes, messages.readReactions, messages.readSavedHistory, messages.reorderPinnedForumTopics, messages.report, messages.reportMessagesDelivery, messages.reportMusicListen, messages.reportReaction, messages.reportReadMetrics, messages.reportSpam, messages.requestAppWebView, messages.requestMainWebView, messages.requestUrlAuth, messages.requestWebView, messages.saveDefaultSendAs, messages.saveDraft, messages.saveGif, messages.saveRecentSticker, 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.sendWebViewData, 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.applyGiftCode, payments.assignAppStoreTransaction, payments.assignPlayMarketTransaction, payments.changeStarsSubscription, payments.connectStarRefBot, payments.craftStarGift, payments.createStarGiftCollection, payments.deleteStarGiftCollection, payments.editConnectedStarRefBot, payments.exportInvoice, 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.refundStarsCharge, payments.reorderStarGiftCollections, payments.resolveStarGiftOffer, payments.sendStarGiftOffer, payments.toggleChatStarGiftNotifications, payments.toggleStarGiftsPinnedToTop, payments.transferStarGift, payments.updateStarGiftCollection, payments.updateStarGiftPrice, payments.upgradeStarGift, phone.createConferenceCall, phone.createGroupCall, phone.declineConferenceCallInvite, phone.deleteConferenceCallParticipants, phone.deleteGroupCallMessages, phone.deleteGroupCallParticipantMessages, phone.discardCall, phone.discardGroupCall, phone.editGroupCallParticipant, phone.editGroupCallTitle, phone.getGroupCallChainBlocks, phone.getGroupCallJoinAs, phone.getGroupCallStreamRtmpUrl, phone.getGroupParticipants, phone.inviteConferenceCallParticipant, phone.inviteToGroupCall, phone.joinGroupCall, phone.joinGroupCallPresentation, phone.leaveGroupCall, phone.leaveGroupCallPresentation, phone.saveDefaultGroupCallJoinAs, phone.saveDefaultSendAs, phone.sendConferenceCallBroadcast, phone.sendGroupCallMessage, phone.setCallRating, phone.startScheduledGroupCall, phone.toggleGroupCallRecord, phone.toggleGroupCallSettings, phone.toggleGroupCallStartSubscription, premium.applyBoost, premium.getBoostsList, premium.getBoostsStatus, premium.getUserBoosts, stats.getPollStats, stats.getStoryPublicForwards, stats.getStoryStats, stickers.changeSticker, stickers.changeStickerPosition, stickers.createStickerSet, stickers.removeStickerFromSet, stickers.replaceSticker, stickers.setStickerSetThumb, stories.activateStealthMode, stories.canSendStory, stories.createAlbum, stories.deleteAlbum, stories.deleteStories, stories.editStory, stories.exportStoryLink, stories.getAlbumStories, stories.getAlbums, stories.getAllReadPeerStories, 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.startLive, stories.togglePeerStoriesHidden, stories.togglePinned, stories.togglePinnedToTop, stories.updateAlbum, users.getSavedMusicByID, users.suggestBirthday
Provenance
Section titled “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
Section titled “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
miniprotoFast paths where they count. Explicit boundaries everywhere else.