Getting a feed of folders to which the user recently added files (My Feed)
Added by IBM contributorIBM | Edited by Claudia R Elbourn on June 30, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Get a feed that lists the folders that the user added files to recently.

Request parameters

Use one or more of the input parameters to narrow the search. Separate multiple parameters with an ampersand (&).
 

Input
Method URI Description
GET /files/{auth}/api/collections/addedto/feed Get a feed that lists the folders that you added files to recentl
Name Type Optional Description
auth
enumerated No The authorization protocol being used by your application to access Connections Cloud.
Authorized values:
  • basic
  • oauth
Name Type Optional Description
access
string Yes Filters the returns by the access role of the authenticated user. Options are editor and manager. You can use this parameter with an authenticated request only.
format
enumerated Yes Specifies the format of the response. Options are atom or json. The default value is atom.
Authorized values:
  • atom
  • json
includeCount
boolean Yes Specifies whether the total number of pinned folders should be returned in the feed. The options are true and false. The default is true.
page
int Yes Page number. Specifies the page to be returned. The default value is 1, which returns the first page.
ps
int Yes Page size. Specifies the number of entries to return per page. The default value is 10. The maximum value you can specify is 500.
Note: This parameter replaces the pageSize parameter. The pageSize parameter is supported for backwards compatibility only; it will be deprecated in a future release.
shared
enumerated Yes Filters the list of results based on whether the folder is shared. Options are true, false, or null. Passing null returns all content, regardless of whether it is shared. If the visibility parameter is public, then this parameter is ignored.
Authorized values:
  • true
  • false
  • null
sI
int Yes Start index. Specifies the start index (number) in the folder from which the results should be returned. This parameter is ignored if the page parameter is provided.
type
enumerated Yes Specifies the types of folders to return in the feed. The options are all, community, and personal. The default value is personal.
Authorized values:
  • all
  • community
  • personal
visibility
enumerated Yes Filters the list of results based on visibility flag. Options are public, private, and null. The default is null, which returns both the public folders, and the private folders that you have pinned.
Authorized values:
  • public
  • private
  • null
Name Type Optional Description
Authorization
enumerated No The authentication mechanism selected by your application to access the API.
Basic is the Base64 encoding of the IBM Connections Cloud username and password: Base64(username:password). For example, Base64(twatson@us.ibm.com:password).
Bearer is the oauth 2.0 access token that is generated when the user grants your application access to IBM Connections Cloud services.
See the reference topic "OAuth 2.0 APIs for web server flow" for more information.
Authorized values:
  • bearer
  • basic
Output
Content Type: application/atom+xml
Code Description
200
OK. Indicates that the request was received successfully.
401
Unauthorized. Returned when no authenticated user or no userid, email, or key parameter are provided on the request.