Overview
Lists users in your PagerDuty account with optional filtering by name and team membership.This is a read-only tool that queries your PagerDuty account without making any changes.
Parameters
Query parameters for filtering and pagination
Response
Returns aListResponseModel[User] containing:
Array of user objects
Usage Examples
List all users
Search for users by name
Filter by team
Limit results
Use Cases
- User discovery - Find users by name or team
- Team management - See which users belong to specific teams
- Audit - Review user roles and access levels
- Integration setup - Get user IDs for assigning incidents or configuring escalations
- Directory - Browse all users in your organization
Notes
The
query parameter performs a partial, case-insensitive match on user names. You don’t need to provide the full name.Related Tools
- get_user_data - Get the current user’s information
- list_teams - List all teams
- list_team_members - List members of a specific team
- add_team_member - Add a user to a team (write mode)