Overview
Retrieves detailed information about a specific team by its ID or name.This is a read-only tool that does not modify any data in your PagerDuty account.
Parameters
The ID or name of the team to retrieve. PagerDuty supports both team IDs (e.g., “P4B2Z3G”) and team names.
Response
Returns a detailed team object with the following fields:The unique identifier for the team
The name of the team
A short description of the team
The full description of the team, if set
Always “team”
Example Usage
Get team by ID
Get team by name
Verify team exists
Common Use Cases
- Team verification - Confirm a team exists before performing operations
- Getting team IDs - Look up the ID for a team when you only know the name
- Team information - Review team details and descriptions
- Validation - Verify team references in configurations or scripts
- Documentation - Generate reports including team information
Related Tools
list_teams
List all teams
list_team_members
View team members
update_team
Modify team details (write mode)
list_services
List services for this team