Skip to content

Get User or Group ​

Looks up a user or group in Autodesk Vault and returns a full profile, including the groups, roles, and vaults they have access to.

Purpose ​

Use this task when a workflow needs details about a Vault user or group — for example, to check which vaults a person can access, to read a user's profile fields before routing work, or to expand a group into its member users and roles. You supply a single identifier and choose whether you are looking up a user or a group; the task finds the matching record and returns a structured profile that downstream tasks can read.

For a user, the identifier can be the Vault user ID, the login/username, or the email address. For a group, it can be the group ID or the group name. Whichever you provide is resolved to the correct Vault record automatically.

Inputs ​

FieldTypeRequiredDescription
TypeDropdownYesWhether to look up a User or a Group.
IdentifierTextYesThe identifier of the user or group to find. For a User this may be the Vault user ID, username, or email address. For a Group it may be the group ID or the group name.

Outputs ​

NameDescription
Foundtrue when a matching user or group was found.
ResultTypeUser or Group, matching the lookup type that was performed.
UserProfile(User lookups) The full user profile object: ID, username, email, first/last name, active/system flags, account type, groups, roles, vaults, and all profile properties.
GroupProfile(Group lookups) The full group profile object: ID, name, active flag, roles, member users, child groups, and vaults.
UserName / GroupNameThe display name of the resolved user or group.
UserId / GroupIdThe Vault ID of the resolved user or group.
Email(User lookups) The user's email address.
FirstName / LastName(User lookups) The user's first and last name, taken from their Vault profile.
AccountType(User lookups) The Vault authentication type of the account.
IsActiveWhether the user or group is active.
Groups(User lookups) The names of the groups the user belongs to.
RolesThe names of the roles held (for a user, including roles inherited through their groups).
VaultsThe names of the vaults the user or group has access to.
Members(Group lookups) The names of the users that are direct members of the group.
SubGroups(Group lookups) The names of any child groups nested inside the group.
ProfileProperties(User lookups) All of the user's Vault profile properties, as name/value pairs.

Tentech