Developers » API methods » stories.getPhotoUploadServer
API methodsstories.getPhotoUploadServer
Returns URL for uploading a story with photo.
This method can be called:
Access rights required: stories.
This method can be called with a community token. Access rights required: stories.
add_to_news1 to add the story to friend's feed.
flag, either 1 or 0
user_idsList of users IDs who can see the story.
list of comma-separated positive numbers
reply_to_storyID of the story to reply with the current.
link_textLink text (for community's stories only). Possible values:
  • to_store;
  • vote;
  • more;
  • book;
  • order;
  • enroll;
  • fill;
  • signup;
  • buy;
  • ticket;
  • write;
  • open;
  • learn_more;
  • view;
  • go_to;
  • contact;
  • watch;
  • play;
  • install;
  • read.
link_urlLink URL. Internal links on only.
string, maximum length 2048
group_idID of the community to upload the story (should be verified or with the "fire" icon).
positive number
JSON data
Returns an object with following fields:
  • upload_url (string) upload URL;
  • user_ids (integer) users ID who can to see story.
19Content blocked
900Can't send messages for users from blacklist
1602Incorrect reply privacy
Global errors can occur while running. See their descriptions on this page.
Version historyShow all
Changed the process of loading stories. Starting from this version, the methods stories.getPhotoUploadServer and stories.getVideoUploadServer in the response of the upload-server will only have one parameter, upload_result (string). To save uploaded stories, you need to additionally call the method and pass the earlier received upload_result to it.
Story attachments are now available in the methods of the messages section.

Messages that do not fit into the Bots Long Poll API or Callback API will be cropped and tagged is_cropped. If cropping occurs, only one forwarded message or reply, and only one attachment will remain for each message.

For methods ads.createTargetGroup and ads.updateTargetGroup, the parameter lifetime is now required. The parameter can have values from 1 to 720.

Stories in stories.get from the same creator are received in chronological order. In the past, it was the other way around.

The parameter clickable_stickers was added to the methods stories.getPhotoUploadServer and stories.getVideoUploadServer