Community specific feeds
Added by IBM contributorIBM | Edited by Claudia R Elbourn on June 30, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Community feeds are used in two places. First of all, when retrieving a users feed, it is often desirable to retrieve only these events that are received as a result of following a community. However, in IBM Connections it is also possible to treat a Community as a user and retrieve a feed specific to that community. In this case the feed refers to all of the events that relate to objects that 'belong' to that community.


Filtering of a users stream based on events they receive as a result of following a community is reasonably simple and involves using the /communities application filter

When are treating communities as a 'pseudo-person', (for beta they are easily identifiable with a prefix 'c!' but this will be changed to a more standard id format for release)
  • This provides a list of all events relating to a community independent of who is following
  • This feed also verifies that the community is either public, or that the viewer is a member of the community (otherwise they would not have rights to view the feed)

Community feeds can be filtered by application just like any other users feed, including by status updates, which provides a view of the 'Community board'

Community View: /activitystreams/

Filtered by Application: /activitystreams/

Filtered by Status Updates: /activitystreams/
Method URI Description
GET /connections/opensocial/{auth}/rest/activitystreams/{communityId}/@all Community view
GET /connections/opensocial/{auth}/rest/activitystreams/{communityId}/@all/{application} Community filtered by application
GET /connections/opensocial/{auth}/rest/activitystreams/{communityId}/@all/status_updates Community view filtered by Status Updates.
Name Type Optional Description
enumerated Yes Application type
Authorized values:
  • activities
  • blogs
  • files
  • forums
  • wikis
  • @people
  • @status
  • @tags
  • @communities
  • bookmarks
string No Community UUID of the community feed you wish to view
enumerated No The authorization protocol being used by your application to access Connections Cloud.
Authorized values:
  • basic
  • oauth
Name Type Optional Description
enumerated No The authentication mechanism selected by your application to access the API.
Basic is the Base64 encoding of the IBM Connections Cloud username and password: Base64(username:password). For example, Base64(
Bearer is the oauth 2.0 access token that is generated when the user grants your application access to IBM Connections Cloud services.
See the reference topic "OAuth 2.0 APIs for web server flow" for more information.
Authorized values:
  • bearer
  • basic
Content Type: application/json
Code Description
Unauthorized. Returned when no authenticated user or no userid, email, or key parameter are provided on the request.