> For the complete documentation index, see [llms.txt](https://docs.pagerly.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagerly.io/sre-ai-agent/data-sources/pagerduty.md).

# PagerDuty

## What the Agent Can Do

* List recent incidents — find related or ongoing incidents
* Get incident details — description, urgency, assignments, timeline
* Acknowledge or resolve alerts during investigation

## Setup Instructions

1. Log into your **PagerDuty account**
2. Go to **Integrations** > **API Access Keys**
3. Click **Create New API Key**
4. Enter a description (e.g., `Pagerly`) and select **Read-only** access
5. Click **Create Key** and copy the API key

## Required Credentials

| Field       | Description                                    | Example          |
| ----------- | ---------------------------------------------- | ---------------- |
| **API Key** | PagerDuty REST API key (read-only recommended) | `u+your-api-key` |

## Context Prompt Tips

> *"Our critical services are api-gateway and payment-service. SEV1 incidents require immediate response. Escalation policy is Backend On-Call."*

## Docs

* [PagerDuty API Reference](https://developer.pagerduty.com/api-reference/)