Sharing API¶
Introduction¶
This document will describe how to use the ownCloud Sharing API. The sharing API allows for the creation of new shares, obtaining a list of shares, and deleting shares. In addition, information such a lists of files shared to users can be obtained.
In order to utilize this API, all user ID’s involved in the share, as well as full path names of files is required to be known.
Two methods will be shown: Firefox Plugin “Poster” and Curl via the command line.
The base URL for all calls to the share API is: owncloud_base_url>/ocs/v1.php/apps/files_sharing/api/v1/shares
Permissions¶
The following table describes the Permissions of a share. The Permissions are contained in the XML code output of the command.
| Value | Permissions |
| 1 | Read only – Default for “public” shares |
| 2 | Update |
| 4 | Create |
| 8 | Delete |
| 16 | Re-share |
| 31 | All above – Default for “private” shares |
To obtain combinations, add the desired values together. For instance, for “Re-Share”, “delete”, “read”, “update”, add 16+8+2+1 = 27.