{"slug":"pagerduty-rest-api","name":"PagerDuty REST API","host":"api.pagerduty.com","site":"https://pagerduty.com","category":"devtools","docsUrl":null,"sources":[{"kind":"openapi","url":"https://raw.githubusercontent.com/PagerDuty/api-schema/main/reference/REST/openapiv3.json"}],"url":"https://www.okapi.bot/providers/pagerduty-rest-api/","json":"https://www.okapi.bot/api/v1/providers/pagerduty-rest-api.json","breakingChanges":[{"slug":"incidents-custom-fields-is-deprecated","api":"pagerduty-rest-api","title":"/incidents/custom_fields is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["/incidents/custom_fields*"],"method":null,"path":"/incidents/custom_fields*","source":{"url":"https://raw.githubusercontent.com/PagerDuty/api-schema/main/reference/REST/openapiv3.json","kind":"archive"},"quote":"This endpoint is deprecated and only works for fields on the Base Incident Type.","migration":"Manage custom fields per incident type with /incidents/types/{type_id_or_name}/custom_fields (and its field_options).","migrationChange":null,"needsDecision":null,"text":{"summary":"PagerDuty has deprecated the /incidents/custom_fields* endpoints without announcing a shutdown date. These routes only work for fields on the Base Incident Type and will eventually fail. The change applies to all requests targeting the legacy incident custom fields path.","migration":"Manage custom fields per incident type using /incidents/types/{type_id_or_name}/custom_fields and its field_options endpoints instead.","by":"writer"},"publishedAt":"2026-10-23T09:58:06.665Z","updatedAt":"2026-10-25T16:34:32.772Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/pagerduty-rest-api/breaking-changes/incidents-custom-fields-is-deprecated/"},{"slug":"users-sessions-is-deprecated","api":"pagerduty-rest-api","title":"/users/{}/sessions is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["/users/{}/sessions*"],"method":null,"path":"/users/{}/sessions*","source":{"url":"https://raw.githubusercontent.com/PagerDuty/api-schema/main/reference/REST/openapiv3.json","kind":"archive"},"quote":"This endpoint is deprecated, please use the [List OAuth Delegations endpoint](https://developer.pagerduty.com/api-reference/4f8e257df4468-list-a-user-s-delegations) instead.","migration":"List a user's OAuth delegations with GET /users/{id}/oauth_delegations; revoke with DELETE /oauth_delegations.","migrationChange":null,"needsDecision":null,"text":{"summary":"PagerDuty deprecated /users/{}/sessions* endpoints without announcing a shutdown date. Subsequent calls will fail once removed. This change affects all requests targeting the deprecated sessions endpoint path.","migration":"List a user's OAuth delegations with GET /users/{id}/oauth_delegations instead. Revoke delegations using DELETE /oauth_delegations.","by":"writer"},"publishedAt":"2026-10-23T09:58:06.665Z","updatedAt":"2026-10-25T16:34:33.591Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/pagerduty-rest-api/breaking-changes/users-sessions-is-deprecated/"}]}