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

KeyDatatypeRequiredDescription
recursivebooleanThis option is only for folder type
forcebooleanThis 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

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

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"}}}}