This API returns information about the membership list for a role--it does not return the actual list of members. However, this API also returns a link that you can use to retrieve the list of users assigned to the role, as explained in Retrieving the list of members for a folder's role.
This method does not require authentication to retrieve public resources. If authentication is provided, the user must have 'View' permission on the folder. View permission is granted through the Reader, Contributor, or Manager role of a folder. To test whether the current user can get a list of roles of a folder, you can also use the Retrieving the list of members for a folder's role to determine whether the user has the Manager role as required.
The following access roles are available:
||View a folder and all media in it.
||Add to a folder and delete items they added.
||Add and remove any item; assign roles.
The following error codes could appear in a response body for an invalid request:
||Returned when the cause of an error is unknown
||Returned when the cause of an error is related to a resource not being found