Find Users

The Find Users task searches for users matching one or more criteria and returns a list of matches. The results are stored in a variable for use by downstream tasks.

Configuration

Property	Type	Description
dry_run	boolean	Run without executing task effects
name	string	Filter by first name (partial match)
surname	string	Filter by last name (partial match)
groups	array	Filter by group membership — returns users who are members of any of the specified groups
scopes	array	Filter by granted scopes
is_active	boolean / null	Filter by active state — true (active only), false (inactive only), null (any)
is_locked	boolean / null	Filter by locked state
limit	number	Maximum number of results to return (default: 100)
output_variable	string	Variable name to store the results array (e.g. "ucs.users")

---

See also: Tasks overview