Share file API - Share via link

Purpose

This api method is used to share content (file or folder) from "my files" or "shared items"

Request URL

POST  /shares/link

Request Body

<share> 
                            <resourcetype>folder/file</resourcetype> {folder/file}

                           <resourceid>integer content id</resourceid> (the id can be any from my files or shared items)

                           <permissions> integer value for the two options </permissions> {1(download_view_print) / 2(view_only)}

                          <shareoption> integer value for the options </shareoption>  {1(anyone) / 2(my organisation user) / 3(system users /4(Can be accessed by anyone who has the password) this 4th option is introduced from API version 6 onwards for sharing password protected files})}
                           <password>12345</password> {This option is only used from API version 6 onwards when the shareoption value is 4}

                          <expiry>UTC date and time(dd MMM yyyy HH:mm)</expiry>

  <share>

All fields in the request body are mandatory.

Sample request xml :
               <share> 
                            <resourcetype>file</resourcetype>
                           <resourceid>53</resourceid>
                           <permissions>1</permissions>
                          <shareoption>1</shareoption>
                          <expiry>09 Dec 2014 13:54</expiry>
                </share>

Sample request xml for sharing password protected file (api version 6 onwards):
              <share> 
                            <resourcetype>file</resourcetype>
                           <resourceid>53</resourceid>
                           <permissions>1</permissions>
                          <shareoption>4</shareoption>
                          <expiry>09 Dec 2014 13:54</expiry> 
                         <password>12345</password>
                </share>

Response XML

Response Codes