Get a feed that lists the top updates. The resulting feed includes updates about events in which the authenticated user is involved. The most recent updates are listed first in the resulting feed.
Table 1. Atom API request details
Gets a feed of the top updates.
This resource continues to be supported for backwards compatibility. However, the /atom/stories/newsfeed resource, which was added in version 3, provides more robust information about the latest updates. This resource (atom/stories/top) is equivalent to atom/stories/newsfeed?source=responses.
See Authenticating requests
for information about how to authenticate the request.
Table 2. Parameters
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 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.
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 number. Specifies the page to be returned. The default value is 1, which returns the first page.
Page size. Specifies the number of entries to return per page. The default value is 10. The maximum value you can specify is 100.
Specify a single application from which you want the feed of updates to be returned. Options are:
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.
You can use the ps and page parameters together.
Parent topic: Getting News repository feeds