PagerDuty Integration
Connect PagerDuty to enable the AI agent to access incidents, on-call schedules, and alert data during investigations.
Capabilities
Once connected, the AI agent can:
| Capability | Description |
|---|---|
| View Incidents | Access PagerDuty incident details and timelines |
| On-Call Schedules | Look up who is currently on call |
| Alert Data | Retrieve alert details and trigger information |
| Service Status | Check service health and escalation policies |
| Incident History | Search past incidents for similar patterns |
Prerequisites
- A PagerDuty account with API access
- A REST API Key (General Access or User Token)
- Read permissions for incidents, services, and schedules
Setup
1
Get Your API Key
- Log in to your PagerDuty account
- Navigate to Integrations → Developer Tools → API Access Keys
- Click Create New API Key
- Enter a description (e.g., "Autoheal Integration")
- Select Read-only API Key if available
- Copy the generated API key
2
Add Integration in Autoheal
- Go to Integrations in Autoheal
- Click PagerDuty
- Enter a name (e.g., "Production PagerDuty")
3
Configure Credentials
Enter the following:
- API Key: Your PagerDuty REST API key
4
Test and Save
Click Test Connection to verify, then Save.
API Key Types
PagerDuty supports two types of REST API keys:
| Type | Scope | Recommended |
|---|---|---|
| General Access REST API Key | Account-wide access | Yes (for org-level visibility) |
| User Token REST API Key | Scoped to a specific user | Yes (for limited access) |
tip
Use a General Access REST API Key for the broadest visibility into incidents and services. If you need to limit scope, use a User Token REST API Key tied to a service account.
Required Permissions
The API key should have at least these permissions:
| Permission | Why It's Needed |
|---|---|
| Read access to Incidents | View incident details and timelines |
| Read access to Services | Check service status |
| Read access to Schedules | Look up on-call information |
| Read access to Users | Identify responders |
Example Queries
Once connected, you can ask the AI agent questions like:
Who is currently on call for the payments team?
Show me all open PagerDuty incidents
What incidents were triggered for the checkout service this week?
Get the timeline for PagerDuty incident #12345
Troubleshooting
401 Unauthorized Error
- Verify the API key is correct and has not been revoked
- Check that the API key has the required permissions
- Ensure the key is a REST API key (not an Events API key)
No Incidents Found
- Verify the time range includes active incidents
- Check that the API key has access to the relevant services
- Ensure there are incidents matching your query criteria
Rate Limiting
- PagerDuty enforces API rate limits
- Reduce query frequency if you encounter 429 errors
- Use more specific queries to reduce the number of API calls