File/folder group and user permissions - Add/update group/user folder permissions
OVERVIEW
This API method adds or updates folder permissions for a group/user. This can only be used when the inheritance has been broken for the specific folder. Please use the change inheritance method for a folder to break the inheritance.
Request URI
PUT /api/3/folders/{folderid}/permissions
Request Body
The request body contains a user group permissions object
Response
The method returns a 200 OK http response if the request was successful with no response body otherwise an error object and error code are returned.
URI Parameters
Parameters |
Value |
Description |
---|---|---|
folderid |
integer |
The ID for the folder. To get the root folderid use following API get site list. The response of that API sitefolderid parameter will give you the root folderid of site. |
Unable to get this working Getting an Access Denied error although the user making the call is a SysAd.
Also when I included disableprint and other parts I received an error about DRM not being enabled. Can I remove disableprint, disablesave and watermark and still make the call?
Can someone publish the JSON version of the user permission object.
I am able to successfully update folder permissions via the API but am having performance issues when a large amount of groups need to be updated. Is there a way to update folder permissions in bulk when a single folder may have 10s or 100s of groups that need to be updated?
My scenario is that we use the API to create a folder in a parent folder where inheritance is disabled. The resulting folder has many groups that have view folder permission since it is assigned at the parent folder level. Our process runs through each of the user groups with view folder permissions (on the newly created folder) and removes them but this has to be done with a single API call for each group. This ends up taking a minute or even several minutes which is too long for our business use case.
Thanks Peter Simpson - I tried updating it but no luck there. I also posted a comment onto that page- https://developerportal.thomsonreuters.com/file-resource/documents/file/folder-group-and-user-permissions---add/update-group/user-folder-permissions
Joe Leung
Look at the documentation for Add/Update Folder... there is an 'accessInherited' flag there. I believe that is what this is reffering to.
I've been trying to find the "change inheritance method" in the docs but can't seem to find it anywhere. Can someone point me in the right direction?
Imran Aziz Fyi, Tim cannot see the attachments, I have sent them to him the old fashioned way :)
Imran Aziz I am looking around the page and cannot find an attachment, where on page should I see it, thanks. Will send screenshot if I don't see the same.
Tim Collins the "postman" scripts are attached to this page, you can import them to the postman application and run them against your Collaborate instance, if you find any issues after using these scripts then please raise it with our support team at support@highq.com they should be able to debug and resolve this issue for you. Thank you.
Hi Tim Collins - I've asked Imran Aziz to have a look into this for you. Please come back to me if you don't receive a response. Thank you.
Just to add I am getting response Forbidden
I am having trouble using this permissions function, is there an example that can be posted, so I can make sure I have all the correct params.
Comments
11 Comments