Print this page

Summer '15 - New and Changed Chatter REST API Resources

Knowledge Article Number 000214072
Description In Summer '15, there are new and changed resources related to communities, feeds, groups, and recommendations.
Resolution

A) Communities

Get a user profile feed that includes only feed elements scoped to a community

Feed elements that have a User or Group parent record type are always scoped to a community. Feed elements with other parent record types (such as Account) are visible across all communities. To get a user profile feed that contains only feed elements scoped to a community, pass a new filter parameter with the value CommunityScoped to these resources:

  • /connect/communities/communityId/chatter/feeds/user-profile /userId/feed-elements?filter=CommunityScoped
             This resource contains feed elements from the community specified in the communityId.
  • /chatter/feeds/user-profile/userId/feed-elements?filter=CommunityScoped     
              This resource contains feed elements from the internal community.

B) Feeds

Edit a comment

Make a PATCH request to the existing /chatter/comments/commentId resource with the Comment Input to edit a comment.

Determine if a comment is editable by the context user

Make a GET request to the new /chatter/comments/commentId/capabilities/edit/is-editable-by-me resource to determine if a comment is editable by the context user.

Edit a post

Make a PATCH request to the existing /chatter/feed-elements/feedElementId resource with the Feed Item Input to edit a post.

Determine if a post is editable by the context user

Make a GET request to the new /chatter/feed-elements/feedElementId/capabilities/edit/is-editable-by-meresource to determine if a post is editable by the context user.

C) Groups

Associate a record with a group

Make a POST request to the existing /chatter/groups/groupID/records resource to associate a record with a group.

Get group records in communities

Make a GET request to the new /connect/communities/communityId/chatter/groups/groupID/records resource to get a list of group records in a community.

Get information about a group record or remove the association between a record and group

Make a GET or DELETE request to the new /chatter/group-records/groupRecordId resource to get information about a group record or to remove the association between a record and a group.

D) Recommendations

Get and delete static recommendations

Make a GET or DELETE request to the new /chatter/users/userId/recommendations/action/objectEnum resource, where action is view and objectEnum is Today, to get or delete a static recommendation that doesn’t have an id.

Get custom recommendations

Make a GET request to these existing resources to get custom recommendations:

  • /chatter/users/userId/recommendations
  • /chatter/users/userId/recommendations/view
  • /chatter/users/userId/recommendations/view/custom
  • /chatter/users/userId/recommendations/view/0RD
  • /chatter/users/userId/recommendations/view/customRecommendationId

Delete custom recommendations

Make a DELETE request to the existing /chatter/users/userId/recommendations/action/objectID resource, whereaction is view and objectId is customRecommendationId, to delete a custom recommendation.

Schedule a recommendation

Make a POST request to the existing /connect/scheduled-recommendations resource or a PATCH request to the existing/connect/scheduled-recommendations/scheduledRecommendationId resource with the new enabled parameter to indicate whether a recommendation is scheduled.

Only community managers (users with the “Create and Set Up Communities” or “Manage Communities” permission) and users with the “Modify All Data” permission can access, create, and delete recommendation definitions and scheduled recommendations. These recommendations appear directly in the feed in communities in the Salesforce1 mobile browser app. They also appear, by default, on the right side of the home page in communities using the Summer ’15 or later version of the Napili template.

Customize the button label for recommendations

Make a POST request to the existing /connect/recommendation-definitions resource or a PATCH request to the existing/connect/recommendation-definitions/recommendationDefinitionId resource with the new actionUrlNameparameter to customize the label for recommendations.

Only community managers (users with the “Create and Set Up Communities” or “Manage Communities” permission) and users with the “Modify All Data” permission can access, create, and delete recommendation definitions and scheduled recommendations. These recommendations appear directly in the feed in communities in the Salesforce1 mobile browser app. They also appear, by default, on the right side of the home page in communities using the Summer ’15 or later version of the Napili template.





promote demote