Function patchFilePermissions

This endpoint is deprecated and will be removed on 3/31/2025. Please use the /files/{assetId}/roles endpoint instead.

This endpoint is used to manage the direct roles of a specific file, identified by its assetId. It allows clients to perform multiple types of role changes in a single request, including:

• Addition of new users or groups to the access control list.
• Update of roles for existing users or groups.
• Removal of users or groups from the access control list.

NOTE:

• The request body supports three arrays: additions, updates, and deletions.
• Multiple principals can be included across each action type.
• Each principal must be mentioned only once across the entire request body.
• Role changes apply directly to the file.

Validation Rules

Action	Behavior
additions	Must include users/groups that do not already exist in the current ACL.
updates	Must target users/groups that already exist in the current ACL.
deletions	Must target users/groups that already exist in the current ACL.