Home
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.
- 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 stories, or Getting a person's updates.
- Copy the <id> element from the update or story into a new Atom entry document. The complete input should look like this:
<?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>
- Send the following request:
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
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. Returned HTTP Headers
- HTTP/1.1 201 Created
- Indicates that the story was successfully saved. If an error occurs, this header will contain one of the error codes below.
- Location: url
- Link to edit_url of the saved story. You can use the Web address specified here to subsequently remove the story from the collection of saved stories.
Error codes
- HTTP/1.1 400 Bad Request
- HTTP/1.1 401 Unauthorized