Community articleSaving stories4.0
Added by IBM contributorIBM on May 1, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

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.



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:

Input

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.

Output

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

Input
Method URI Description
POST /news/atom/stories/saved Value of the href attribute of the "Stories saved by {user name}" collection in the saved stories service document
Content Type: application/atom+xml
Sample Request:
<?xml version="1.0" encoding="UTF-8"?>

	<entry xmlns="http://www.w3.org/2005/Atom">

	<id>urn:lsid:ibm.com:news:story-68d3c957-aa73-46b2-8435-92b77b89c4ca</id>

	</entry>
Name Type Optional Description
userid
string No userid of "Saved stories" user
Output
Code Description
201
Indicates that the story was successfully saved. If an error occurs, this header contains one of the error codes.
400
Bad Request.
401
Unauthorized.