Files Feed Resources

Returns the URL to the feed-items that contain files that are posted by users or groups the logged-in user is following.

Resource

1/chatter/feeds/files/me

OR

1/chatter/feeds/files/userId

userId must be the ID of the logged-in user or the alias me.

Note

Available since version

23.0

HTTP methods

GET or HEAD

Request parameter

Parameter Name	Type	Description
sort	String	Specifies the order returned by the sort, such as by date created or last modified: CreatedDateDesc—Sorts the feed items by most recent post date. LastModifiedDateDesc—Sorts the feed items by most recent activity, which includes new feed items and comments. The default value is CreatedDescDate.

Response body

Feed

Returns all feed items posted with files by people or groups that the logged-in user follows.

Resource

1/chatter/feeds/files/me/feed-items

or

1/chatter/feeds/files/userId/feed-items

userId must be the ID of the logged-in user or the alias me.

Note

Available since version

23.0

HTTP methods

GET or 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 posts and comments from people and records the user follows and groups the user is a member of. FewerUpdates—Displays all posts and comments from people and records the user follows and groups the user is a member of, but hides system-generated posts from records that nobody commented on. The default value is AllUpdates.	Optional	29.0
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, for example: 1"nextPageUrl": 2"/services/data/v30.0/ 3chatter/feeds/news/ 4005D0000001GLowIAN 5/feed-items 6?page=2011-03-30T17:34:50Z, 70D5D0000000DSv4KAG"	Optional	23.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
q	String	One or more keywords to search for in the body and comments of feed items 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
recentComment​Count	Integer	Maximum number of comments to include per feed item. The default value is 3. The maximum value is 25.	Optional	29.0
sort	String	Specifies the order returned by the sort, such as by date created or last modified: CreatedDateDesc—Sorts the feed items by most recent post date. LastModifiedDateDesc—Sorts the feed items by most recent activity, which includes new feed items and comments. The default value is CreatedDescDate.	Optional	23.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 Item Page response body.	Optional	30.0

Response body

Feed Item Page

Response body example

1{
2   "currentPageUrl" : "/services/data/v30.0/chatter/feeds/files/005D0000001L3zVIAS/feed-items?page=2012-04-17T18%3A13%3A57Z", 
3   "isModifiedToken" : null,
4   "isModifiedUrl" : null 
5   "items" : [ ], 
6   "nextPageUrl" : null, 
7   }

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

1/chatter/feeds/files/me/feed-items/flat

or

1/chatter/feeds/files/userId/feed-items/flat

userId must be the ID of the logged-in user or the alias me.

Note

Available since version

25.0

HTTP methods

GET or HEAD

Request parameters

Parameter Name	Type	Description
numFeedItems	Integer	Specifies the number of feed items returned. Valid values are between 0 and 100. Default value is 25. Because feed items may 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.
recentComment​Count	Integer	Specifies the number of recent comments returned. Valid values are between 0 and 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