Filter Feed Resources

The filter feed is the news feed filtered to contain feed elements whose parent is a specified object type.

Available resources are:

Resource	Description
`/chatter/feeds/filter/userId`	A collection of feed directory objects that contain information about filter feeds available to the context user. Each object contains a URL for the filter feed, a URL for feed items or feed elements in the filter feed, and a label describing the object used to filter the feed.
`/chatter/feeds/filter/userId/idPrefix`	A feed object that contains information about a specific filter feed available to the context user.
`/chatter/feeds/filter/userId/idPrefix/feed-elements`	Feed elements from the context user’s news feed whose parent has the specified key prefix, such as the feed elements from all the groups the context user is a member of.

List of Filter Feed URLs

A collection of feed directory objects that contain information about filter feeds available to the context user. Each object contains a URL for the filter feed, a URL for feed items or feed elements in the filter feed, and a label describing the object used to filter the feed. Each URL contains the first three characters of the filter object, which is called a key prefix and specifies the object type. Use this resource to return a list of the possible key prefix filter feeds that the context user can apply to their news feed. See Filter Feed Elements.

The collection of feed directory objects never contains User (005) and Group (0F9) object types. However, you can use those object types to filter the feed.

Note

Resource

1/chatter/feeds/filter/userId

1/connect/communities/communityId/chatter/feeds/filter/userId

userId must be the ID of the context user or the alias me.

Available since version

23.0

Requires Chatter

Yes

HTTP methods

GET or HEAD

Response body

Feed Directory

If the response body is empty, the user isn’t following any records.

Specific Filter Feed URL

A feed object that contains information about a specific filter feed available to the context user. The keyPrefix in the resource URL is the first three characters of the object ID and indicates the object type.

Resource

1/chatter/feeds/filter/userId/keyPrefix

1/connect/communities/communityId/chatter/feeds/filter/userId/keyPrefix

userId must be the ID of the context user or the alias me.

Available since version

23.0

Requires Chatter

Yes

HTTP methods

GET or HEAD

Request parameters

Parameter Name	Type	Description
`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. The default value is `CreatedDateDesc`.

Response body

Feed

Example request

This request returns the URL for a filter feed items resource that’s filtered by the User object (key prefix 005).

1GET /chatter/feeds/filter/me/005

Connect REST API Developer Guide

Filter Feed Resources

List of Filter Feed URLs

Specific Filter Feed URL