Community articleGetting a feed of saved updates4.0
Added by IBM contributorIBM | Edited by IBM contributorLDD Webmaster on July 1, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Get a feed that lists the updates that have been saved by the user who authenticates the request. The most recent updates are listed first in the resulting feed.



Get a feed that lists the updates that have been saved by the user who authenticates the request. The most recent updates are listed first in the resulting feed.
 

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

Note: The userid parameter is required.

You can use the ps and page parameters together.

 

Input
Method URI Description
GET /news/atom/stories/saved Gets a feed of the updates that have been saved by the user who authenticated the request. The userid parameter is required. You must provide the userid of the person whose saved updates you are interested in.
Name Type Optional Description
before
string Yes Returns only those items that were last modified before the date specified by this parameter. Format the date using the syntax: 2008-02-07T21:07:56Z. See ftp://ftp.rfc-editor.org/in-notes/rfc4287.txt for details.
container
string Yes Unique ID of one of the following items:
An activity in the Activities application
A blog in the Blogs application
A person's bookmark collection in the Bookmarks application
A community in the Communities application
A collection in the Files application
A forum in the Forums application
A person's profile in the Profiles application
A wiki in the Wikis application
The unique ID is defined in the <id> element for the Atom entry for the container. Each application defines Atom entry content and part of this content is the <id> element. Use this parameter with the source parameter. In the source parameter, specify the application in which this unique ID for the item is valid. This parameter is ignored if a valid application name is not specified in the source parameter.
email
string Yes email address of a person. Use this parameter to limit the feed of updates to contain only updates generated by a specific person. Do not use this parameter if IBM® Connections is configured to hide email addresses; use userid instead.
lang
string Yes Use this parameter to request stories in a different language than specified in the HTTP request. To specify the language, use one of the following formats:
Java™ format (e.g. en_US, es_ES)
Dojo format (e.g. en-us, es-es)
page
int Yes Page number. Specifies the page to be returned. The default value is 1, which returns the first page.
ps
int Yes Page size. Specifies the number of entries to return per page. The default value is 10. The maximum value you can specify is 100.
since
string Yes Returns only those items that were last modified after the date specified by this parameter. Format the date using the syntax: 2008-02-07T21:07:56Z. See ftp://ftp.rfc-editor.org/in-notes/rfc4287.txt for details.
source
enumerated Yes Specify a single application from which you want the feed of updates to be returned. Options are:
activities
blogs
communities
dogear
files
forums
profiles
wikis

Authorized values:
  • activities
  • blogs
  • communities
  • dogear
  • files
  • forums
  • profiles
  • wikis
userid
string Yes Unique ID of a person. Use this parameter to limit the feed of updates to contain only updates generated by a specific person. The value of this parameter takes precedence when both this and the email parameter are specified.
Output
Content Type: application/atom+xml
Code Description
200
OK. Indicates that the request was received successfully.