Community articleActivities API
Added by IBM contributorIBM | Edited by IBM contributorDana Liburdi on February 25, 2013
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Collect, organize, share, and reuse work related to a project goal. You can create new activities and read and modify existing activities. Open Authorization (OAuth) is required when using the implementation of the Activities APIs.



Collect, organize, share, and reuse work related to a project goal. You can create new activities and read and modify existing activities. Open Authorization (OAuth) is required when using the implementation of the Activities APIs.

IBM SmartCloud™ for Social Business supports the Activities APIs that are provided in IBM® Connections 4.0. For details about the IBM Connections Activities APIs, see Activities API.

Most changes that were implemented in the latest version of the Activities APIs are based on providing more consistency across APIs. These changes are listed here.

New feed elements

New elements are added to the following feeds:
  • Activity feed: http://<server>/activities/service/atom2/activity?activityUuid=<activityUuid>
  • Activity dashboard for a user: https://<server>/activities/service/atom2/activities
Table 1. New feed elements
Change
Element added
Determine whether an item is contained within a community and the associated community ID.
<snx:communityUuid xmlns:snx="http://www.ibm.com/xmlns/prod/sn">17e765b6-3c05-40a6-845b-2b6bb4dbab8e</snx:communityUuid>
Link to the community to retrieve any necessary additional information.
<link rel="http://www.ibm.com/xmlns/prod/sn/container"
type="application/atom+xml"
href="http://<server>/communities/service/atom/community/instance?communityUuid=<community-guid>" />




Note: Now each item that is identified with the communityUuid component also has the link element. This update applies to the Activities APIs and to any applications that have community-related elements.

Page size

The default value for the page size parameter is 10, and the maximum value is 100. If users specify values greater than 100, the size resets back to 100. This change in page size behavior applies to all activities.

New parameters

Activities APIs now support sortBy and sortOrder parameters instead of sortfields and sortorder parameters. The new URL parameters are case-sensitive. For the sortBy parameter, the lastmod value is now modified, and the name value is now title.