PagerDuty

PagerDuty Incidents API

An incident represents a problem or an issue that needs to be addressed and resolved. Incidents trigger on a service, which prompts notifications to go out to on-call responders per the service's escalation policy.

GitHub OpenAPI
Business capability
Incident Response Management BC-4220.30

Operations 26

GET /incidents PagerDuty List incidents #
PUT /incidents PagerDuty Manage incidents #
POST /incidents PagerDuty Create an Incident #
GET /incidents/{id} PagerDuty Get an incident #
PUT /incidents/{id} PagerDuty Update an incident #
GET /incidents/{id}/alerts PagerDuty List alerts for an incident #
PUT /incidents/{id}/alerts PagerDuty Manage alerts #
GET /incidents/{id}/alerts/{alert_id} PagerDuty Get an alert #
PUT /incidents/{id}/alerts/{alert_id} PagerDuty Update an alert #
PUT /incidents/{id}/business_services/{business_service_id}/impacts PagerDuty Manually change an Incident's Impact on a Business Service #
GET /incidents/{id}/business_services/impacts PagerDuty List Business Services impacted by the given Incident #
GET /incidents/{id}/custom_fields/values PagerDuty Get Custom Field Values #
PUT /incidents/{id}/custom_fields/values PagerDuty Update Custom Field Values #
GET /incidents/{id}/log_entries PagerDuty List log entries for an incident #
PUT /incidents/{id}/merge PagerDuty Merge incidents #
GET /incidents/{id}/notes PagerDuty List notes for an incident #
POST /incidents/{id}/notes PagerDuty Create a note on an incident #
GET /incidents/{id}/outlier_incident PagerDuty Get Outlier Incident #
GET /incidents/{id}/past_incidents PagerDuty Get Past Incidents #
GET /incidents/{id}/related_incidents PagerDuty Get Related Incidents #
POST /incidents/{id}/responder_requests PagerDuty Create a responder request for an incident #
POST /incidents/{id}/snooze PagerDuty Snooze an incident #
POST /incidents/{id}/status_updates PagerDuty Create a status update on an incident #
GET /incidents/{id}/status_updates/subscribers PagerDuty List Notification Subscribers #
POST /incidents/{id}/status_updates/subscribers PagerDuty Add Notification Subscribers #
POST /incidents/{id}/status_updates/unsubscribe PagerDuty Remove Notification Subscriber #

Documentation

📖
Documentation
https://developer.pagerduty.com/api-reference/
📖
Authentication
https://developer.pagerduty.com/docs/authentication
📖
GettingStarted
https://developer.pagerduty.com/docs/rest-api-v2/rest-api/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/pagerduty/refs/heads/main/openapi/pagerduty-incidents-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/pagerduty/refs/heads/main/asyncapi/pagerduty-events-asyncapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/pagerduty-incidents-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

pagerduty-incidents-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: 'This document describes the PagerDuty REST APIs.


    For guides and examples please visit our Documentation.


    Our REST APIs are defined in OpenAPI v3.x. You can view the schema at github.com/PagerDuty/api-schema.


    Note that properties in some schemas have fields not shown by default such as `readOnly`, `format`, and `default`. Hover your cursor over the right column that looks like `optional+1` to see the full list of fields.'
  contact:
    name: PagerDuty Support
    url: http://www.pagerduty.com/support
    email: support@pagerduty.com
  title: PagerDuty Incidents API
  version: 2.0.0
servers:
- url: https://api.pagerduty.com
  description: PagerDuty V2 API.
security:
- api_key: []
tags:


# --- truncated at 32 KB (194 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/pagerduty/refs/heads/main/openapi/pagerduty-incidents-api-openapi.yml