Saving stories 

To save an item that is displayed in the Updates tab of the Home page so you can read it later, send a request to your saved stories feed with the ID of the update or story you want to save for later. A copy is added to your saved stories, and given a new ID.

See Authenticating requests for information about how to authenticate the request.

  1. Find the update that you want to save as a saved story in one of the supported feeds. See Getting a feed of all public updates, Getting the top updates, or Getting a person's updates.

  2. Copy the <id> element from the update or story into a new Atom entry document. The complete input should look like this:

  3. Send the following request:

Table 1. Atom API request details

Method Resource Address Input representation
POST Value of the href attribute of the "Stories saved by {user name}" collection in the saved stories service document Story Atom entry document


An Atom entry document containing the <id> element of the story or update that you want to save. The content type header for the Atom entry document must be application/atom+xml.


An Atom entry document containing the new copy of the story added to your saved stories.

Returned HTTP headers

HTTP/1.1 201 Created

Location: url

Error codes

Parent topic

Work with stories

Related reference
Getting a feed of all public updates
Getting the top updates
Getting a person's updates