Chatter REST API Developer Guide
jNewer Version Available
Groups Feed Resources
Available resources are:
| Resource | Description |
|---|---|
| /chatter/feeds/groups/me | Returns a URL to the feed elements for all the groups the context user is a member of. |
| /chatter/feeds/groups/me/feed-elements | Returns all feed elements for all groups the context user either owns or is a member of. |
Groups Feed URL
Returns a URL to the feed elements for all the groups the context user is a member of.
- Resource
-
- Available since version
- 23.0
- Requires Chatter
- Yes
- HTTP methods
- GET
- Request parameters
-
- Response body
- Feed
Groups Feed Elements
Returns all feed elements for all groups the context user either owns or is a member of.
To get the feed elements for a specific group, use the record feed resource (/chatter/feeds/record/recordId/feed-elements) and substitute the group ID for the recordId.
- Resource
-
- Available since version
- 31.0
- Requires Chatter
- Yes
- HTTP methods
- GET, HEAD
- Request parameters
-
Parameter Name Type Description Required or Optional Available Version density String The density of the feed. One of these values: - AllUpdates—Displays all updates from people and records the user follows and groups the user is a member of. Also displays custom recommendations.
- FewerUpdates—Displays all updates from people and records the user follows and groups the user is a member of. Also displays custom recommendations, but hides some system-generated updates from records.
The default value is AllUpdates.
Optional 31.0 elementsPerBundle Integer Maximum number of feed elements to include in a bundle. The value must be an integer from 0 through 10. The default value is 3. Optional 31.0 page String A generated token that indicates the view of feed elements in the feed. Page tokens are returned as part of the response body in one of the URL parameters, such as nextPageURL:Optional 31.0 pageSize Integer Specifies the number of elements per page. Valid values are from 1 through 100. If you don't specify a size, the default is 25. Optional 31.0 q String One or more keywords to search for in the body and comments of feed elements in this feed. The search string can contain wildcards and must contain at least two characters that aren’t wildcards. See Wildcards.
Optional 31.0 recentCommentCount Integer Maximum number of comments to include per feed element. The default value is 3. The maximum value is 25. Optional 31.0 sort String Order of feed items in the feed. - CreatedDateAsc—Sorts by oldest creation date. This sort order is available only for DirectMessageModeration, Draft, Moderation, and PendingReview feeds.
- CreatedDateDesc—Sorts by most recent creation date.
- LastModifiedDateDesc—Sorts by most recent activity.
- MostViewed—Sorts by most viewed content. This sort order is available only for Home feeds when the ConnectApi.FeedFilter is UnansweredQuestions.
- Relevance—Sorts by most relevant content. This sort order is available only for Company, Home, and Topics feeds.
Optional 31.0 updatedSince String An opaque token defining the modification time stamp of the feed and the sort order. Do not construct this token. Retrieve this token from the updatesToken property of the Feed Element Page response body.
The updatedSince parameter doesn’t return feed elements that are created in the same second as the request.
Optional 31.0 - Response body
- Feed Element Page
Groups Feed Items
Returns all feed items for all groups the context user either owns or is a member of.
To get the feed items for a specific group, use the record feed resource (/chatter/feeds/record/recordId/feed-items) and substitute the group ID for the recordId.
- Resource
-
or
- Available versions
- 23.0–31.0
- Requires Chatter
- Yes
- HTTP methods
- GET, HEAD
- Request parameters
-
Parameter Name Type Description Required or Optional Available Version density String The density of the feed. One of these values: - AllUpdates—Displays all updates from people and records the user follows and groups the user is a member of. Also displays custom recommendations.
- FewerUpdates—Displays all updates from people and records the user follows and groups the user is a member of. Also displays custom recommendations, but hides some system-generated updates from records.
The default value is AllUpdates.
Optional 29.0–31.0 page String A generated token that indicates the view of feed elements in the feed. Page tokens are returned as part of the response body, in one of the URL parameters, such as nextPageURL, for example:Optional 23.0–31.0 pageSize Integer Specifies the number of items per page. Valid values are between 1 and 100. If you don't specify a size, the default is 25. Optional 23.0–31.0 q String One or more keywords to search for in the body and comments of feed elements in this feed. The search string can contain wildcards and must contain at least two characters that aren’t wildcards. See Wildcards.
Optional 28.0–31.0 recentCommentCount Integer Maximum number of comments to include per feed item. The default value is 3. The maximum value is 25. Optional 29.0–31.0 sort String Order of feed items in the feed. - CreatedDateAsc—Sorts by oldest creation date. This sort order is available only for DirectMessageModeration, Draft, Moderation, and PendingReview feeds.
- CreatedDateDesc—Sorts by most recent creation date.
- LastModifiedDateDesc—Sorts by most recent activity.
- MostViewed—Sorts by most viewed content. This sort order is available only for Home feeds when the ConnectApi.FeedFilter is UnansweredQuestions.
- Relevance—Sorts by most relevant content. This sort order is available only for Company, Home, and Topics feeds.
Optional 23.0–31.0 updatedSince String An opaque token defining the modification time stamp of the feed and the sort order. Do not construct this token. Retrieve this token from the updatesToken property of the Feed Element Page response body.
Optional 30.0–31.0 - Response body
- Feed Item Page
Groups Feed Items Flat
This resource is deprecated as of version 26.0.
Returns a flat feed, that is, a feed where there is no hierarchy between feed items and comments: Feed items and comments are at the same level. All items are returned in chronological order.
- Resource
-
or
- Available since version
- 25.0–26.0
- Requires Chatter
- Yes
- HTTP methods
- GET or HEAD
- Request parameters
-
Parameter Name Type Description numFeedItems Integer Specifies the number of feed items returned. Valid values are from 0 through 100. Default value is 25. Because feed items can include comments, specifying 25 flat feed items may actually return more. For example, if each feed item has one comment, and recentCommentCount is greater than 1, 50 flat feed items are returned. page String A generated token that indicates the view of feed items in the feed. Page tokens are returned as part of the response body, in one of the URL parameters, such as nextPageURL. recentCommentCount Integer Specifies the number of recent comments returned. Valid values are from 0 through 25. Default value is 3. sort String. One of the following: - CreatedDateDesc
- LastModifiedDateDesc
Sorts the returned feed either by created date in ascending order, or by last modified date, also in ascending order. The default is LastModifiedDateDesc - Response body
- Flat Feed