PagerDuty API breaking changes & specification history.
Incidents, on-call schedules, and escalation policies.
5 recorded releases · Last captured 1 Oct 2026.
Which PagerDuty API endpoints have captured breaking changes?
5 recorded releases; last specification capture . This dated snapshot contains 32 sampled findings from 5 recent releases, including 9 breaking findings. Up to ten findings are retained per release; these counts are not totals for the complete API history.
Snapshot retrieved . A capture date is not a provider deployment date. Missing or unmatched repository usage is not proof of safety.
| Classification | Sampled findings |
|---|---|
| Breaking | 9 |
| Non-breaking | 6 |
| Needs review | 17 |
| Deprecation | 0 |
| Pending classification | 0 |
| Operation | Field and rule | Capture |
|---|---|---|
PUT /v3/schedules/{id}/rotations/{rotation_id}/events/{event_id} | event/assignment_strategyrequest.now_required | |
PUT /v3/schedules/{id}/custom_shifts/{custom_shift_id} | custom_shift/end_timerequest.now_required | |
PUT /v3/schedules/{id}/custom_shifts/{custom_shift_id} | custom_shift/assignmentsrequest.now_required | |
GET /v3/schedules/{id}/custom_shifts | offsetresponse.removed | |
PUT /v3/schedules/{id} | Operation-level changeschema.request_acceptance_narrowed | |
PUT /v3/schedules/{id}/custom_shifts/{custom_shift_id} | Operation-level changeschema.request_acceptance_narrowed | |
PUT /event_orchestrations/services/{service_id} | Operation-level changerequest.content_removed | |
PUT /event_orchestrations/{id}/global | Operation-level changerequest.content_removed | |
PUT /event_orchestrations/{id}/router | Operation-level changerequest.content_removed |
Where does this evidence come from?
- Publisher specification
- Official specification source
- Configured SDK matching
- No SDK package listed in this snapshot
- API authentication
- none
- Publisher version
- 2.0.0
Snapshot captured 3 Nov 2026. Breaking describes contract evidence; repository impact is a separate analysis.
PagerDuty captured release evidence
Dated snapshot: . Latest 5 captured releases, with up to ten findings per release. Contract findings describe specification changes; repository impact is a separate analysis.
PagerDuty API specification changes · Revision cb9f5748 · GET /incidents/{id}/scribe_transcripts
GET /incidents/{id}/scribe_transcripts2 recorded findings · classified · Previous revision 46bd6195
Non-breaking: GET /incidents/{id}/scribe_transcripts
endpoint added
Rule: level.info
Non-breaking: GET /incidents/{id}/scribe_transcripts
endpoint added
Rule: level.info
PagerDuty API specification changes · Revision 46bd6195 · PUT /v3/schedules/{id}/rotations/{rotation_id}/events/{event_id}
PUT /v3/schedules/{id}/rotations/{rotation_id}/events/{event_id}97 recorded findings · classified · Previous revision 6c19f1f4
Breaking: PUT /v3/schedules/{id}/rotations/{rotation_id}/events/{event_id}
the request property `event/assignment_strategy` became required
Field: event/assignment_strategy
Rule: request.now_required
Non-breaking: GET /v3/schedules/{id}
added the enum value `users` to the property `items/` of the `query` request parameter `include[]`
Field: items/
Rule: request.enum_added
Needs review: GET /v3/schedules/{id}/custom_shifts
deleted the `query` request parameter `offset`
Field: offset
Rule: request.removed_unknown_strictness
Breaking: PUT /v3/schedules/{id}/custom_shifts/{custom_shift_id}
the request property `custom_shift/end_time` became required
Field: custom_shift/end_time
Rule: request.now_required
Breaking: PUT /v3/schedules/{id}/custom_shifts/{custom_shift_id}
the request property `custom_shift/assignments` became required
Field: custom_shift/assignments
Rule: request.now_required
Needs review: GET /v3/schedules/{id}/custom_shifts
deleted the `query` request parameter `limit`
Field: limit
Rule: request.removed_unknown_strictness
Breaking: GET /v3/schedules/{id}/custom_shifts
removed the optional property `offset` from the response with the `200` status
Field: offset
Rule: response.removed
Breaking: PUT /v3/schedules/{id}
Validated schema comparison changed the request accepted instance set.
Rule: schema.request_acceptance_narrowed
Breaking: PUT /v3/schedules/{id}/custom_shifts/{custom_shift_id}
Validated schema comparison changed the request accepted instance set.
Rule: schema.request_acceptance_narrowed
Needs review: GET /v3/schedules/{id}/custom_shifts
Validated schema comparison changed the response accepted instance set.
Rule: schema.response_expansion_consumer_policy
Showing the first ten findings. Open the release for the remaining changes.
PagerDuty API specification changes · Revision 6c19f1f4 · PUT /event_orchestrations/services/{service_id}
PUT /event_orchestrations/services/{service_id}43 recorded findings · classified · Previous revision 0fa55620
Non-breaking: PUT /event_orchestrations/services/{service_id}
added `#/components/schemas/ParityDiffShared_2cc43bf1bf2ff14f8fba472b0fbb1b26ded9719a5c41c500356e4f4fc19c60bc, #/components/schemas/ParityDiffShared_86cf585a29666c522c4f649fecf8e306afa7c33676dbed88a1f2454efb2ac72d` to the response body `allOf` list for the response status `200`
Rule: level.info
Needs review: PUT /event_orchestrations/{id}/global
added `#/components/schemas/ParityDiffShared_f1413903e573bc7dc07c9cf367f940785ae795cfd7ed43c545d5791f0ba20c2a` to the request body `allOf` list
Rule: level.warning
Breaking: PUT /event_orchestrations/services/{service_id}
removed `#/components/schemas/ParityDiffShared_1c2ca86a40f1053cf61d3a9950b72070fe4f0925cf8979ba6867b62cecf01744` from the request body `allOf` list
Rule: request.content_removed
Non-breaking: PUT /event_orchestrations/{id}/global
added `#/components/schemas/ParityDiffShared_ac3f6a0c0953caa104fc1d54bb0c0706091a501694b3f33ad076d9a8ad13e0ce, #/components/schemas/ParityDiffShared_86cf585a29666c522c4f649fecf8e306afa7c33676dbed88a1f2454efb2ac72d` to the response body `allOf` list for the response status `200`
Rule: level.info
Needs review: PUT /services/{id}/enablements/{feature_name}
Schema acceptance comparison is unavailable; compatibility requires review.
Rule: coverage.incomplete
Breaking: PUT /event_orchestrations/{id}/global
removed `#/components/schemas/ParityDiffShared_032e5c5ab36f01ad87a88bfd8c8a4afee3ffbbce0921f0352886ff7fa77be758` from the request body `allOf` list
Rule: request.content_removed
Needs review: GET /event_orchestrations/services/{service_id}
removed `#/components/schemas/ParityDiffShared_1c2ca86a40f1053cf61d3a9950b72070fe4f0925cf8979ba6867b62cecf01744` from the response body `allOf` list for the response status `200`
Rule: level.warning
Non-breaking: GET /event_orchestrations/services/{service_id}
added `#/components/schemas/ParityDiffShared_ff65da2430ca710454a1af6146b14751924bf4eaefa17337d24bc9a8e0ce3aeb` to the response body `allOf` list for the response status `200`
Rule: level.info
Needs review: GET /event_orchestrations/{id}/router
removed `#/components/schemas/ParityDiffShared_8da434e50739d1aa4fb774a3810df205de74127e9f9479fa4f4a1e7ca113a3b6` from the response body `allOf` list for the response status `200`
Rule: level.warning
Breaking: PUT /event_orchestrations/{id}/router
removed `#/components/schemas/ParityDiffShared_8da434e50739d1aa4fb774a3810df205de74127e9f9479fa4f4a1e7ca113a3b6` from the request body `allOf` list
Rule: request.content_removed
Showing the first ten findings. Open the release for the remaining changes.
PagerDuty API specification changes · Revision 0fa55620
0 recorded findings · no changes · Previous revision 212611b8
No classified endpoint findings recorded for this release.
PagerDuty API specification changes · Revision 212611b8 · GET /ip_allow_lists
GET /ip_allow_lists12 recorded findings · classified · Previous revision 7cab7262
Needs review: GET /ip_allow_lists
deleted the `header` request parameter `x-early-access`
Field: x-early-access
Rule: request.removed_unknown_strictness
Needs review: GET /ip_allow_lists/{id}/audit/records
deleted the `header` request parameter `x-early-access`
Field: x-early-access
Rule: request.removed_unknown_strictness
Needs review: POST /ip_allow_lists
deleted the `header` request parameter `x-early-access`
Field: x-early-access
Rule: request.removed_unknown_strictness
Needs review: PUT /ip_allow_lists/{id}
deleted the `header` request parameter `x-early-access`
Field: x-early-access
Rule: request.removed_unknown_strictness
Needs review: DELETE /ip_allow_lists/{id}
deleted the `header` request parameter `x-early-access`
Field: x-early-access
Rule: request.removed_unknown_strictness
Needs review: GET /ip_allow_lists/{id}
deleted the `header` request parameter `x-early-access`
Field: x-early-access
Rule: request.removed_unknown_strictness
Needs review: DELETE /ip_allow_lists/{id}
deleted the `header` request parameter `x-early-access`
Rule: request.removed_unknown_strictness
Needs review: POST /ip_allow_lists
deleted the `header` request parameter `x-early-access`
Rule: request.removed_unknown_strictness
Needs review: GET /ip_allow_lists/{id}
deleted the `header` request parameter `x-early-access`
Rule: request.removed_unknown_strictness
Needs review: GET /ip_allow_lists
deleted the `header` request parameter `x-early-access`
Rule: request.removed_unknown_strictness
Showing the first ten findings. Open the release for the remaining changes.