get_escalation_policies

Retrieve PagerDuty escalation policies by ID or filter by user/team IDs, names, or context. Use to manage and access escalation details with structured inputs and outputs.

Instructions

Get PagerDuty escalation policies by filters or get details for a specific policy ID.

Args: policy_id (str): The escalation policy ID to retrieve (optional, cannot be used with any other filters). current_user_context (bool): Use current user's ID/team IDs context (default: True). Not used if policy_id is provided. query (str): Policies whose names contain the search query (optional). Not used if policy_id is provided. user_ids (List[str]): Policies that include these user IDs (optional, excludes current_user_context). Not used if policy_id is provided. team_ids (List[str]): Policies assigned to these team IDs (optional, excludes current_user_context). Not used if policy_id is provided. limit (int): Limit the number of results (optional). Not used if policy_id is provided.

Input Schema

Name	Required	Description	Default
`current_user_context`	No
`limit`	No
`policy_id`	No
`query`	No
`team_ids`	No
`user_ids`	No

Input Schema (JSON Schema)

{
  "properties": {
    "current_user_context": {
      "default": true,
      "title": "Current User Context",
      "type": "boolean"
    },
    "limit": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Limit"
    },
    "policy_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Policy Id"
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Query"
    },
    "team_ids": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Team Ids"
    },
    "user_ids": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "User Ids"
    }
  },
  "type": "object"
}

PagerDuty MCP Server