Home

 

Get a feed of file shares

Get a feed that lists the share entries. A share entry describes an instance in which access that has been given to a file. This returns a feed of shares to which the authenticated user has access.


Atom API request details

Resource Description
/basic/api/myshares/feed A feed of shares

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


Input parameters

Parameter Description
direction Specifies which shares to return. Options are:

    inbound

    Files shared with you.

    outbound

    Files you have shared.

includePath Specifies whether or not to return the <td:path> element that shows the path to the object. This parameter takes a boolean value of either true or false. By default, the path is not returned.
owner User ID of the person whose files you want to return. Specify null if you want to return all files no matter the owner.
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.
sharedBy String. User ID. Filter the list of results by the creator of the share. Passing null returns all shared regardless of the person who created it.
sharedWhat String. Uuid. Filter the list of results by the unique ID of the resource being shared. If direction=outbound is also specified, this parameter is ignored.
sharedWith Sting. User ID. Filter the list of results based on a person with whom the file has been shared. Passing a null value returns all shares regardless of the person it was shared with. If direction=inbound is also specified, this parameter is ignored. Does not support multivalue.
sharePermission Filters the list of results based on the permission level granted in the share. The options are Edit or View. Passing null returns all shares regardless of the permissions.
sI Start index. Specifies the start index (number) in the collection from which the results should be returned. This parameter is ignored if a page parameter is provided.
tag String. Filters the list of results by tag. You can specify up to three keywords by default. To specify multiple tags, either separate the tag names with commas or provide the tag parameter multiple times. Providing more than one tag has the effect of an AND operator.
visibility Defines who has access to the files. Options are: public or private. If you set this parameter equal to

public

, only public files are returned. If you set this parameter equal to

private

, only private files are returned.

You can find out a person's user ID by retrieving the person's profile feed. See Searching Profiles for more information.

 

Example

To search for all of the files that you have shared with others, send the following HTTP request:

The HTTP response would look as follows:

The following content is returned by the server:


Get Files feeds

 

Related reference


Searching Profiles


+

Search Tips   |   Advanced Search