PUT api/2.0/files/folder/{folderId}/share
Sets the sharing settings to a folder with the ID specified in the request.
Name |
Description |
Type |
Example |
folderId
sent in url
|
Folder ID
|
string
|
some text
|
share
sent in body
|
Collection of sharing parameters
|
Collection of ASC.Api.Documents.FileShareParamss
collection
|
|
notify
sent in body
|
Notifies users about the shared folder or not
|
Bool value
|
true
|
sharingMessage
sent in body
|
Message to send when notifying about the shared folder
|
string
|
some text
|
Each of the sharing parameters must contain two values: "ShareTo" - ID of the user with whom we want to share a folder, "Access" - access type which we want to give to the user (Read, ReadWrite, etc).
PUT api/2.0/files/folder/%22some+text%22/share
Host: yourportal.onlyoffice.com
Content-Type: application/json
Accept: application/json
{
"share": [
{
"shareTo": "2fdfe577-3c26-4736-9df9-b5a683bb8520",
"access": "0"
}
],
"notify": true,
"sharingMessage": "some text"
}
Shared folder information
application/json
{
"status": 0,
"response": [
{
"Access": 1,
"SharedTo": {
"id": "00000000-0000-0000-0000-000000000000",
"displayName": "Mike Zanyatski",
"title": "Manager",
"avatarSmall": "url to small avatar",
"profileUrl": ""
},
"IsLocked": false,
"IsOwner": true
}
]
}
text/xml
<result>
<status>0</status>
<response>
<Access>1</Access>
<SharedTo>
<id>00000000-0000-0000-0000-000000000000</id>
<displayName>Mike Zanyatski</displayName>
<title>Manager</title>
<avatarSmall>url to small avatar</avatarSmall>
<profileUrl />
</SharedTo>
<IsLocked>False</IsLocked>
<IsOwner>True</IsOwner>
</response>
</result>