Skip to main content

​
Overview

Retrieves information about the currently authenticated user (the user associated with the API token being used).
This is a read-only tool that queries your PagerDuty account without making any changes.

​
Parameters

This tool takes no parameters. It automatically retrieves data for the user associated with the API token.

​
Response

Returns a User object:
​
id
string
The ID of the user
​
summary
string
A short-form, server-generated string providing succinct information about the user
​
name
string
The name of the user
​
email
string
The email address of the user
​
role
string
The user’s role in PagerDuty. Possible values:
  • admin - Full administrative access
  • limited_user - Limited user access
  • observer - Read-only observer access
  • owner - Account owner
  • read_only_user - Read-only user access
  • restricted_access - Restricted access
  • read_only_limited_user - Read-only limited user
  • user - Standard user access
​
teams
array
List of teams the user belongs to
​
type
string
Always “user”

​
Usage Examples

​
Get your own user information

Who am I logged in as?

Show me my user information

What teams am I on?

​
Check your role

What role do I have in PagerDuty?

​
Use Cases

  • Identity verification - Confirm which user account the API token belongs to
  • Permission checking - Verify your role before attempting operations
  • Team membership - See which teams you belong to
  • Troubleshooting - Debug permission issues by checking user details

Build docs developers (and LLMs) love

Get started for freeTalk to us