ApplyInheritedAccessList

# ApplyInheritedAccessList API

Applies the inherited (parent) access list to the specified document or folder, overwriting any custom security settings.

Endpoint¶

/srv.asmx/ApplyInheritedAccessList

Methods¶

GET /srv.asmx/ApplyInheritedAccessList?authenticationTicket=...&Path=...
POST /srv.asmx/ApplyInheritedAccessList (form data)
SOAP Action: http://tempuri.org/ApplyInheritedAccessList

Parameters¶

Parameter	Type	Required	Description
`authenticationTicket`	string	Yes	Authentication ticket obtained from `AuthenticateUser`.
`Path`	string	Yes	Full path to the document or folder.

Response¶

Success Response¶

<response success="true" error="" />

Error Response¶

<response success="false" error="[ErrorCode] Error message" />

Required Permissions¶

Change security permission on the target document or folder.

Example¶

GET Request¶

GET /srv.asmx/ApplyInheritedAccessList
  ?authenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301
  &Path=/Finance/Reports/Q4Report.pdf
HTTP/1.1

POST Request¶

POST /srv.asmx/ApplyInheritedAccessList HTTP/1.1
Content-Type: application/x-www-form-urlencoded

authenticationTicket=3f2504e0-4f89-11d3-9a0c-0305e82c3301
&Path=/Finance/Reports/Q4Report.pdf

SOAP Request¶

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:tns="http://tempuri.org/">
  <soap:Body>
    <tns:ApplyInheritedAccessList>
      <tns:AuthenticationTicket>3f2504e0-4f89-11d3-9a0c-0305e82c3301</tns:AuthenticationTicket>
      <tns:Path>/Finance/Reports/Q4Report.pdf</tns:Path>
    </tns:ApplyInheritedAccessList>
  </soap:Body>
</soap:Envelope>

Notes¶

This operation removes any custom access list entries on the target item and reverts it to inherit security from its parent folder.
For documents: the document's security is reset to inherited mode.
For folders: the folder's security is reset to inherited mode.
Once applied, the item's effective permissions will be determined by the nearest ancestor with a custom access list.
To set a custom access list, use SetAccessList.
To view the current access list, use GetAccessList.

SetAccessList - Set a custom access list on a document or folder
GetAccessList - Retrieve the current access list
GetOwner - Retrieve the owner of a document or folder

Error Codes¶

Error	Description
`[900] Authentication failed`	Invalid or missing authentication ticket.
`[901] Session expired or Invalid ticket`	The ticket has expired or does not exist.
Path not found	The specified document or folder does not exist.
Access denied	The calling user lacks permission to change security on this item.
`SystemError:...`	An unexpected server-side error occurred.

For detailed documentation visit: https://support.inforouter.com/api-docs/ApplyInheritedAccessList