Get User

The Get User task retrieves a single user account by one of their unique identifiers. The user object is stored in a variable for use in downstream tasks.

Configuration

Property	Type	Description
dry_run	boolean	Run without executing task effects
id	string	Internal user ID — provide exactly one of id, login, or email
login	string	Username
email	string	Email address
fail_if_not_found	boolean	Fail if no user matching the provided identifier exists
output_variable	string	Variable name to store the retrieved user object (e.g. "ucs.user")

TIP

Use Get User when you need to look up one specific, known user. Use Find Users when you need to search across multiple users by criteria.

---

See also: Tasks overview