| name | pagerduty |
| description | PagerDuty REST API for incidents, on-call schedules, and escalation policies |
| license | MIT |
Base URL: https://api.pagerduty.com
Write actions need: From: <email> — fetch from /users/me first.
Spec: https://raw.githubusercontent.com/PagerDuty/api-schema/main/REST/openapi.yaml
Role permissions table
| Action | Works at user role? |
|---|
| Read endpoints (oncalls, incidents, services) | ✅ |
POST /incidents (ack, resolve, snooze, note) | ✅ requires From: header |
PUT /services/{id} name/description | ✅ if manager on service team |
PUT /services/{id} other fields | ❌ silent — field echoes but is dropped |
POST /addons | ❌ 403 admin-only |
POST /incident_workflows write | ❌ admin-only |
Notes
- Incident IDs: short
incident_number (integer) vs long ID (e.g. P12ABCD). Write endpoints use the long ID.
/oncalls with no filter returns the entire account roster — filter by escalation_policy_ids[] or schedule_ids[] for large orgs.
- Pagination: list endpoints default to 25 items. Add
&limit=100&offset=0 for more.