get_user
Fetches user details from IBM Engineering Lifecycle Management (ELM), supporting search by user UUID or search term with automatic wildcard matching.
Purpose
This tool retrieves user information from IBM ELM applications (CCM, RM, or QM). You can search by user UUID (identifier starting with underscore) or by search term (minimum 3 characters). If a search term is provided and multiple users match, the tool returns a list to choose from.
Tags: CCM | QM | RM | Read | Basic
The tool supports two search methods:
- By user UUID: Direct lookup using the user's unique identifier (starts with underscore)
- By search term: Text-based search with automatic wildcard matching (minimum 3 characters)
You must provide either user_uuid OR search_term, but not both.
Input parameters
| Name | Type | Required | Description |
|---|---|---|---|
| app_type | string | Yes | Application type. Valid values:CCM,RM, orQM |
| user_uuid | string | No | User UUID starting with underscore. Optional ifsearch_term is provided. Example:_abc123def456 |
| search_term | string | No | Search term to find users (minimum 3 characters). Optional ifuser_uuid is provided. Wildcards are added automatically. Example:john orsmith |
Output schema
| Field | Type | Description |
|---|---|---|
| userUUID | string | Unique identifier for the user (starts with underscore) |
| userId | string | User's login ID |
| name | string | Full name of the user |
| emailAddress | string | User's email address |
| archived | boolean | Indicates if the user account is archived (true) or active (false) |
Common use cases
- Looking up user details by UUID for assignment operations
- Finding users by name or email for collaboration
- Validating user existence before creating assignments
- Retrieving user information for audit or reporting
- Searching for users to add to project teams
- Checking user archived status before operations