IRPCUsersAdmin.SearchForUser

Administration API / specialized admin session

Finds the user account of a login name.

Service	Users `MFiles.IRPCUsersAdmin`
gRPC method	`/MFiles.IRPCUsersAdmin/SearchForUser`
HTTP (mf-http-grpc)	`POST /grpc/v1/search-for-user`
Request	`SearchForUserRequest`
Response	`SearchForUserResponse`
Book and level	Administration API, specialized
Kind	admin
Session	Required: the session ID from LogIn in the mfiles-session-id-bin metadata.
Idempotent	no
Returns metadata structure version	no
Streaming	none (unary)

Remarks

Requires the vault right manage_users.
Matches the whole login name, case-insensitively; there are no wildcards or partial matches. Returns an empty list, not an error, when no account matches.

Request: SearchForUserRequest

Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.

Field	Type	Description
`account_name`	`string`	The login name to look for, for example `MikeT` or `DOMAIN\user`.

Response: SearchForUserResponse

Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page. Fields marked (recursive) refer to a type already on their path.

Field	Type	Description
`results[]`	repeated `UserAccount`	The matching user account, or empty.
`results[].id`	`int32`	The ID of the user account.
`results[].login_name`	`string`	The login name that is associated with this user account (e.g. 'DOMAIN\user').
`results[].vault_roles`	`VAULTROLES`	Bitmask of the vault roles of the user.
`results[].vault_roles.all`	`bool`	Specifies all flags set; Including any future flags.
`results[].vault_roles.full_control`	`bool`	Can perform any activity in the vault.
`results[].vault_roles.can_log_in`	`bool`	Can log in to the vault.
`results[].vault_roles.can_create_objects`	`bool`	Can create new documents.
`results[].vault_roles.can_see_all_objects`	`bool`	Sees all documents in listings, regardless of security settings and deletion state.
`results[].vault_roles.can_undelete_objects`	`bool`	Can undelete previously deleted documents.
`results[].vault_roles.can_destroy_objects`	`bool`	Has permission to permanently destroy documents.
`results[].vault_roles.can_force_undo_checkout`	`bool`	Has permission to undo a check-out performed by another user.
`results[].vault_roles.can_change_all_object_permissions`	`bool`	Can change the security settings of all documents and modify all documents.
`results[].vault_roles.can_change_metadata_structure`	`bool`	Can modify the meta data structure of the vault (propertydefs, profiles, value lists etc.).
`results[].vault_roles.can_manage_users`	`bool`	Can create, edit and delete user accounts. Cannot add or remove the Vault Manager role.
`results[].vault_roles.is_internal_user`	`bool`	An internal user of the vault. This role separates internal enad external users in the vault.
`results[].vault_roles.can_manage_traditional_folders`	`bool`	Can create, modify and delete traditional folders. OBSOLETE: const VAULTROLES VAULTROLE_DEFINE_TEMPLATES = 1 << 12; //!< Can define templates.
`results[].vault_roles.can_manage_common_views`	`bool`	Can create, modify and delete common views.
`results[].vault_roles.can_manage_workflows`	`bool`	Can create, modify and delete workflows. Modifying event handlers within the workflow still requires SERVERACCESS_RUN_CODE.
`results[].vault_roles.cannot_manage_private_views`	`bool`	Cannot create or modify private views.
`results[].vault_roles.anonymous`	`bool`	Anonymous role.
`results[].vault_roles.run_code_on_server`	`bool`	Can run code on the server hosting this vault. Not included in VAULTROLE_FULL_CONTROL, and cannot be ordinarily granted by it.
`results[].acl`	`AccessControlList`	Permissions.
`results[].acl.checked_out_to_user`	`int32`	Specifies the ID of the user who has extended rights because of the checkout operation performed by her. 0 if such user does not exist.
`results[].acl.is_fully_authoritative`	`bool`	Specifies whether this access control list is set to ignore the secondary permissions that come from the latest checked in version.
`results[].acl.custom_component`	`AccessControlListComponent`	Accesses the custom component of this ACL.
`results[].acl.restrictive_components[]`	repeated `AccessControlListComponentMapEntry`	Accesses the restrictive automatic components of this ACL.
`results[].acl.secondary_access_control_list`	`AccessControlList` (recursive)	Secondary ACL used for latest version ACL. Not used for access check if null.
`results[].acl.additive_components[]`	repeated `AccessControlListComponentMapEntry`	Accesses the additive automatic components of this ACL.
`results[].user_language`	`int32`	The vault language of the user.
`results[].external_id`	`string`	The user identity in external system, such as Microsoft Entra (where the identity is a GUID). Read-only.