Skip to main content

​
Overview

Retrieves detailed information about a specific service. Use this tool when you need to examine the complete configuration and details of a particular service.
This is a read-only tool. It retrieves data without modifying your PagerDuty account.

​
Parameters

​
service_id
string
required
The ID of the service to retrieve.Example: PSERVICE1

​
Response

Returns a single Service object with complete details.
​
id
string
The unique identifier for the service.
​
type
string
required
The type of the object (always "service").
​
name
string
The name of the service.
​
description
string
The description of the service.
​
escalation_policy
EscalationPolicyReference
required
Reference to the escalation policy associated with this service.
​
teams
TeamReference[]
List of teams associated with the service.

​
Example Usage

Show me details for service PSERVICE1

​
Example Response

{
  "id": "PSERVICE1",
  "type": "service",
  "name": "Production Web Service",
  "description": "Main web application service handling user requests",
  "escalation_policy": {
    "id": "PEPOLICY1",
    "type": "escalation_policy_reference",
    "summary": "Production Escalation Policy"
  },
  "teams": [
    {
      "id": "PTEAM1",
      "type": "team_reference",
      "summary": "Engineering Team"
    },
    {
      "id": "PTEAM2",
      "type": "team_reference",
      "summary": "DevOps Team"
    }
  ]
}

list_services

List all services

update_service

Update service configuration

list_incidents

List incidents for this service

get_escalation_policy

View escalation policy details

Build docs developers (and LLMs) love

Get started for freeTalk to us