Update permits for an ACL associated with an object
PATCH {{baseUrl}}/instances/:category/:type/:id/acl?recursive=false&force=false
Grant and revoke both supports same set of permits. In the below example, mentioned the list of possible permissions for grant and revoke. Only those permission that exists on ACL can be revoked, error is thrown otherwise.
Note:Global Records Manager role is required to create/update/remove REMOVEPOLICY and REMOVEHOLD permits on acl.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
recursive | boolean | This option is only for folder type | |
force | boolean | This option is only for folder type |
Request Body
{"grant"=>[{"identity"=>"kate@innovate.com", "identity_type"=>"user", "permissions"=>["browse", "read_content", "relate", "lock", "write", "write_content", "delete", "change_permission", "change_owner", "change_location", "change_folder_links", "create_link", "delete_link", "add_member", "delete_member", "show_members", "apply_policy", "apply_hold", "version"]}], "revoke"=>[{"identity"=>"kate@innovate.com", "identity_type"=>"user", "permissions"=>["browse", "read_content", "relate", "lock", "write", "write_content", "delete", "change_permission", "change_owner", "change_location", "change_folder_links", "create_link", "delete_link", "add_member", "delete_member", "show_members", "apply_policy", "apply_hold", "version"]}]}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"name":"enim qui","permits":[{"identity":"qui","identity_type":"tenant_group","permissions":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}]},{"identity":"dolore commodo","identity_type":"tenant_group","permissions":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}]}],"id":"7883ae6e-3569-5e65-20fb-44e9318e9455","display_name":"sit proident commodo dolore","description":"pariatur consequat eu irure","internal":false,"owner":{"id":"65833def-9e69-e1c4-1dd6-ac38c38da1ad","identity_type":"quis offi","user_profile":{"first_name":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"last_name":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"email":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}},"named":false,"etag":-90104749,"_links":{"self":{"href":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"edit":{"href":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"urn:eim:linkrel:delete":{"href":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"urn:eim:linkrel:localizations":{"href":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}}}