Getting a feed of public file folders
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 public file folders.

You do not need to authenticate the request.

Request parameters

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

Method URI Description
GET /files/{auth}/api/collections/feed Get a feed that lists public file folders.
Name Type Optional Description
enumerated No The authorization protocol being used by your application to access Connections Cloud.
Authorized values:
  • basic
  • oauth
Name Type Optional Description
string Yes User ID. Specifies to return only file folders created by the user specified by the user ID.
int Yes Page number. Specifies the page to be returned. The default value is 1, which returns the first page
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.
int Yes Start index. Specifies the start index (number) in the folder from which the results should be returned. This parameter is ignored if a page parameter is provided.
enumerated Yes String. Specifies what to sort the returned entries by. Options are:
Sorts the entries by the date the item was created.
Sorts the entries by the last modified date.
Sorts the entries by the date the item was published (usually related to atom:published element).
Sorts the entries alphabetically by title. The title used is the text that is displayed in the <title> element of each entry in the feed.
Sorts the entries by the last time the item was updated.
The default value of this parameter is modified.
Authorized values:
  • created
  • modified
  • published
  • title
  • updated
enumerated Yes Specifies the order in which to sort the results. The options are:
Sorts the results in ascending order.
Sorts the results in descending order.
If a value is specified for the sortBy parameter, but none is specified for this parameter, then this parameter defaults to asc. If neither is specified, this parameter defaults to desc.
Authorized values:
  • asc
  • desc
string Yes String. Specifies the title of the folder to return.
Name Type Optional Description
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(
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
Content Type: application/atom+xml
Code Description
OK. Indicates that the request was received successfully.
Unauthorized. Returned when no authenticated user or no userid, email, or key parameter are provided on the request.