Record Feed Resource

The feed of the specified record, which could be a group, person, object, file and so on. You can post feed items to the record feed. You can get another user’s record feed.

Available resources are:

Resource Description
/chatter/feeds/record/recordId Returns a URL to the feed elements for all the records the context user is following, or a URL to all the feed elements of the specified recordId. Use this resource to get a group feed.
/chatter/feeds/record/recordId/feed-elements Returns the feed elements for all the records the context user is following, or all the feed elements of the specified recordId. Use this resource to search a feed or to get the feed elements for a specific feed, including another user’s feed. To use this resource to get the feed elements for a group, specify the group ID as the recordId.
/chatter/feeds/record/recordId/​pinned-feed-elements Get pinned feed elements from a group feed. Pin or unpin a feed element to a group feed.

Record Feed URL

Returns a URL to the feed elements for all the records the context user is following, or a URL to all the feed elements of the specified recordId. Use this resource to get a group feed.

Resource
/chatter/feeds/record/recordId
/connect/communities/communityId/chatter/feeds/record/recordId

If recordId is a user ID, it must be the same as the context user or the alias me.

Note

Available since version
23.0
Requires Chatter
Yes
HTTP methods
GET, HEAD
Request parameters
Parameter Name Type Description
sort String Order of feed items in the feed.
  • CreatedDateAscSorts by oldest creation date. This sort order is available only for DirectMessageModeration, Draft, Isolated, 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.
The default value is CreatedDateDesc.
Response body
Feed

Record Feed Elements

Returns the feed elements for all the records the context user is following, or all the feed elements of the specified recordId. Use this resource to search a feed or to get the feed elements for a specific feed, including another user’s feed. To use this resource to get the feed elements for a group, specify the group ID as the recordId.

Resource
/chatter/feeds/record/recordId/feed-elements
/connect/communities/communityId/chatter/feeds/record/recordId/feed-elements

If recordId is a user ID, it must be the same as the context user or the alias me.

Note

Available since version
23.0
Requires Chatter
Yes
HTTP methods
GET, HEAD
Request parameters for GET
Parameter Name Type Description Required or Optional Available Version
customFilter String Custom filter that applies only to the case feed. See customFeedFilter in the Metadata API Developer Guide for supported values.

You can specify customFilter or filter. You can’t specify both.

Optional 40.0
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 between 0 and 10. The default value is 3.

Bundled posts contain feed-tracked changes and are in record feeds only.

Note

Optional 31.0
filter String Specifies a filter value for a feed.
  • AllQuestions—Feed elements that are questions.
  • AuthoredBy—Feed elements authored by the user profile owner. This value is valid only for the UserProfile feed.
  • CommunityScoped—Feed elements that are scoped to Experience Cloud sites. Currently, these feed elements have a User or a Group parent record. However, other parent record types could be scoped to sites in the future. Feed elements that are always visible in all sites are filtered out. This value is valid only for the UserProfile feed.
  • QuestionsWithCandidateAnswersFeed elements that are questions that have candidate answers associated with them. This value is valid only for users with the Access Einstein-Generated Answers permission.
  • QuestionsWithCandidateAnswers​ReviewedPublishedFeed elements that are questions that have candidate answers that have been reviewed or published. This value is valid only for users with the Access Einstein-Generated Answers permission.
  • Read—Feed elements that are older than 30 days or are marked as read for the context user. Includes existing feed elements when the context user joined the group. This value is valid only for the Record feed of a group.
  • SolvedQuestions—Feed elements that are questions and that have a best answer.
  • UnansweredQuestions—Feed elements that are questions and that don’t have any answers.
  • UnansweredQuestionsWithCandidate​AnswersFeed elements that are questions that don’t have answers but have candidate answers associated with them. This value is valid only for users with the Access Einstein-Generated Answers permission.
  • Unread—Feed elements that are created in the past 30 days and aren’t marked as read for the context user. This value is valid only for the Record feed of a group.
  • UnsolvedQuestions—Feed elements that are questions and that don’t have a best answer.

The filter parameter doesn’t work for group feeds.

Note

You can specify customFilter or filter. You can’t specify both.

Optional 32.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:
"nextPageUrl": 
"/services/data/v64.0/
chatter/feeds/news/
005D0000001GLowIAN
/feed-elements
?page=2011-03-30T17:34:50Z,
0D5D0000000DSv4KAG"
Optional 31.0
pageSize Integer Specifies the number of elements per page. Valid values are between 1 and 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
recentComment​​Count Integer Maximum number of comments to include per feed element. The default value is 3. The maximum value is 25. Optional 31.0
showInternal​​Only Boolean Specifies whether to show only feed elements from internal (non-site) users (true), or not (false). The default value is false. Optional 31.0
sort String Order of feed items in the feed.
  • CreatedDateAscSorts by oldest creation date. This sort order is available only for DirectMessageModeration, Draft, Isolated, 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.
The default value is CreatedDateDesc.
Optional 31.0
threaded​Comments​Collapsed Boolean Specifies whether to return threaded comments in a collapsed style (true) or not (false). If you don’t specify a value, the default is false. Optional 44.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 for GET
Feed Element Page