telegram api method · layer 229 · #8f9e6898
stories.sendStory
Uploads a Telegram Story.
definition
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;
parameters
| name | type | description |
|---|---|---|
flags | # | Flags, see TL conditional fields |
pinned | true | Whether to add the story to the profile automatically upon expiration. If not set, the story will only be added to the archive, see here » for more info. |
noforwards | true | If set, disables forwards, screenshots, and downloads. |
fwd_modified | true | Set this flag when reposting stories with fwd_from_id+fwd_from_id, if the media was modified before reposting. |
peer | InputPeer | The peer to send the story as. |
media | InputMedia | The story media. |
media_areas | Vector<MediaArea> | Media areas associated to the story, see here » for more info. |
caption | string | Story caption. |
entities | Vector<MessageEntity> | Message entities for styled text, if allowed by the stories_entities client configuration parameter ». |
privacy_rules | Vector<InputPrivacyRule> | Privacy rules for the story, indicating who can or can't view the story. |
random_id | long | Unique client message ID required to prevent message resending. |
period | int | Period after which the story is moved to archive (and to the profile if pinned is set), in seconds; must be one of 6 * 3600, 12 * 3600, 86400, or 2 * 86400 for Telegram Premium users, and 86400 otherwise. |
fwd_from_id | InputPeer | If set, indicates that this story is a repost of story with ID fwd_from_story posted by the peer in fwd_from_id. |
fwd_from_story | int | If set, indicates that this story is a repost of story with ID fwd_from_story posted by the peer in fwd_from_id. |
albums | Vector<int> | If set, adds the story to the specified albums. |
music | InputDocument |
returns
errors (20)
| 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. |
history
present in layers 160–229 · constructor id changed 5×
| id | layers |
|---|---|
| #424cd47a | 160 |
| #d455fcec | 161–163 |
| #bcb73644 | 164–166 |
| #e4e6694b | 167–210 |
| #737fc2ec | 211–223 |
| #8f9e6898 | 224–229 |