Released in 1.47.
Finds a list of users based on a specified role or feature entitlement.
This endpoint returns only exact matches of the specified criteria, while Search Users can return inexact matches.
To filter users by feature, first call User Features to retrieve valid feature entitlement values.
Note - Suspension
userSystemInfofrom the payload includes suspension info:
- if user is active, then the
suspendedattribute is set to false,
- if user is suspended, then the
suspendedattribute is set to true and both
suspensionReasonare as well included in the payload.
Please note that even if the suspendedUntil date is in the past, the user will remain suspended=true until he first logs on the client after the suspension ended. The suspended info are then automatically updated.
See the Suspend User Account endpoint for more information.
Calling this endpoint requires the User Provisioning role with ACCESS_USER_PROVISIONING_API privilege.
See Bot Permissions for a list of roles and associated privileges.