Get a feed of your pinned folders 

Get a feed that lists file folders that you have pinned.

Table 1. Atom API request details

Resource Description
/basic/api/myfavorites/collections/feed A feed of all file folders that the authenticated user has pinned. You must authenticate this request.

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

Table 2. Input parameters

Parameter Description
access 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.
creator User ID. Specifies to return only file folders created by the user specified by the user ID.
format String. Specifies the format of the response. Options are atom or json. The default value is atom.
includeCount 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 Page number. Specifies the page to be returned. The default value is 1.
pageSize Page size. Specifies the number of entries to be returned per page.
shared 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.
sharedWithMe Filters the list of results based on whether the authenticated user was added to the folder and assigned to a specific role, and did not create the folder. Options are true or false. Defaults to false.
sI 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.
sortBy String. Specifies what to sort the returned entries by. Options are:

    Organize the entries by folder creation date.


    Organize the entries by the file modification date.


    Organize the entries by the folder publication date.


    Organize the entries by title. The title is specified in the <title> element of the entry.


    Organize the entries by last time that the folder was updated.

The default value of this parameter is displayOrder.

sortOrder Defines the order in which to sort the results. Options are:




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.

title String. Specifies the title of the folder to return.
type String. Specifies the types of folders to return in the feed. The options are all, community, and personal. The default value is personal.
visibility 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.

Request header:

> GET /files/basic/api/myfavorites/collections/feed HTTP/1.1
> Authorization: Basic xxx
> Host:
> Accept: */*

Request response:

< HTTP/1.1 200 OK
< Content-Type: application/atom+xml; charset=UTF-8
< Content-Language: en-US

Returned feed:

  <link href="" rel="self"/>
  <link href="" rel="alternate"/>
  <title type="text">Pinned Folders Feed</title>
    <name>Lyla Mahler</name>
  <generator version="" uri="">IBM Connections - Files</generator>
    <snx:rank scheme="">0</snx:rank>
    <snx:rank scheme="">0</snx:rank>
    <snx:rank scheme="">0</snx:rank>
     rel="alternate" type="text/html"/>
    <category term="collection" scheme=",2006:td/type" label="collection"/>
      <name>Lyla Mahler</name>
      <name>Lyla Mahler</name>
    <title type="text">Sales</title>
    <summary type="text"/>

Parent topic

Getting Files feeds