{
  "info": {
    "_postman_id": "993ef3a7-8460-4627-aff3-52e1dec48cf0",
    "name": "PagerDuty Abilities API",
    "description": "This document describes the PagerDuty REST APIs.\n\nFor guides and examples please visit our [Documentation.](https://developer.pagerduty.com/docs/get-started/getting-started/)\n\nOur REST APIs are defined in OpenAPI v3.x. You can view the schema at [github.com/PagerDuty/api-schema](https://github.com/PagerDuty/api-schema).\n\nNote 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.\n\n\nContact Support:\n Name: PagerDuty Support\n Email: support@pagerduty.com",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "createdAt": "2026-07-28T02:30:33.000Z",
    "updatedAt": "2026-07-28T02:30:34.000Z",
    "lastUpdatedBy": "35240",
    "uid": "35240-993ef3a7-8460-4627-aff3-52e1dec48cf0"
  },
  "item": [
    {
      "name": "abilities",
      "item": [
        {
          "name": "{id}",
          "item": [
            {
              "name": "PagerDuty Test an ability",
              "id": "67b780fa-95de-4cdf-b9ff-9fe31d7d250d",
              "protocolProfileBehavior": {
                "disableBodyPruning": true
              },
              "request": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/abilities/:id",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "abilities",
                    ":id"
                  ],
                  "variable": [
                    {
                      "id": "a379d5be-d11c-4ec8-a85e-e890fb044290",
                      "key": "id",
                      "value": "<string>",
                      "description": "(Required) The ID of the resource."
                    }
                  ]
                },
                "description": "Test whether your account has a given ability.\n\n\"Abilities\" describes your account's capabilities by feature name. For example `\"teams\"`.\n\nAn ability may be available to your account based on things like your pricing plan or account state.\n\nFor more information see the [API Concepts Document](../../api-reference/ZG9jOjI3NDc5Nzc-api-concepts#abilities)\n\nScoped OAuth requires: `abilities.read`\n"
              },
              "response": [
                {
                  "id": "f96823b1-e0ba-4d2c-a360-fa1a561fab15",
                  "name": "The account has the requested ability.",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "description": "Added as a part of security scheme: apikey",
                        "key": "Authorization",
                        "value": "<API Key>"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/abilities/:id",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "abilities",
                        ":id"
                      ],
                      "variable": [
                        {
                          "key": "id"
                        }
                      ]
                    }
                  },
                  "status": "No Content",
                  "code": 204,
                  "_postman_previewlanguage": "text",
                  "header": [],
                  "cookie": [],
                  "responseTime": null,
                  "body": null,
                  "createdAt": "2026-07-28T02:30:34.000Z",
                  "updatedAt": "2026-07-28T02:30:34.000Z",
                  "uid": "35240-f96823b1-e0ba-4d2c-a360-fa1a561fab15"
                },
                {
                  "id": "d2fa03a6-8994-46d2-b134-60049cda9cc0",
                  "name": "Caller did not supply credentials or did not provide the correct credentials.\nIf you are using an API key, it may be invalid or your Authorization header may be malformed.\n",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      },
                      {
                        "description": "Added as a part of security scheme: apikey",
                        "key": "Authorization",
                        "value": "<API Key>"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/abilities/:id",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "abilities",
                        ":id"
                      ],
                      "variable": [
                        {
                          "key": "id"
                        }
                      ]
                    }
                  },
                  "status": "Unauthorized",
                  "code": 401,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "cookie": [],
                  "responseTime": null,
                  "body": "{\n  \"error\": {\n    \"code\": \"<integer>\",\n    \"message\": \"<string>\",\n    \"errors\": [\n      \"<string>\",\n      \"<string>\"\n    ]\n  }\n}",
                  "createdAt": "2026-07-28T02:30:34.000Z",
                  "updatedAt": "2026-07-28T02:30:34.000Z",
                  "uid": "35240-d2fa03a6-8994-46d2-b134-60049cda9cc0"
                },
                {
                  "id": "43386c91-5cda-4aa5-902a-c363d2f2f2dc",
                  "name": "Account does not have the abilities to perform the action. Please review the response for the required abilities.\nYou can also use the [Abilities API](#resource_Abilities) to determine what features are available to your account.\n",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      },
                      {
                        "description": "Added as a part of security scheme: apikey",
                        "key": "Authorization",
                        "value": "<API Key>"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/abilities/:id",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "abilities",
                        ":id"
                      ],
                      "variable": [
                        {
                          "key": "id"
                        }
                      ]
                    }
                  },
                  "status": "Payment Required",
                  "code": 402,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "cookie": [],
                  "responseTime": null,
                  "body": "{\n  \"error\": {\n    \"code\": \"<integer>\",\n    \"message\": \"<string>\",\n    \"errors\": [\n      \"<string>\",\n      \"<string>\"\n    ]\n  }\n}",
                  "createdAt": "2026-07-28T02:30:34.000Z",
                  "updatedAt": "2026-07-28T02:30:34.000Z",
                  "uid": "35240-43386c91-5cda-4aa5-902a-c363d2f2f2dc"
                },
                {
                  "id": "c4d04f9c-c755-4285-b004-60c87ae9a3b7",
                  "name": "Caller is not authorized to view the requested resource.\nWhile your authentication is valid, the authenticated user or token does not have permission to perform this action.\n",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      },
                      {
                        "description": "Added as a part of security scheme: apikey",
                        "key": "Authorization",
                        "value": "<API Key>"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/abilities/:id",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "abilities",
                        ":id"
                      ],
                      "variable": [
                        {
                          "key": "id"
                        }
                      ]
                    }
                  },
                  "status": "Forbidden",
                  "code": 403,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "cookie": [],
                  "responseTime": null,
                  "body": "{\n  \"error\": {\n    \"code\": \"<integer>\",\n    \"message\": \"<string>\",\n    \"errors\": [\n      \"<string>\",\n      \"<string>\"\n    ]\n  }\n}",
                  "createdAt": "2026-07-28T02:30:34.000Z",
                  "updatedAt": "2026-07-28T02:30:34.000Z",
                  "uid": "35240-c4d04f9c-c755-4285-b004-60c87ae9a3b7"
                },
                {
                  "id": "8b909e97-23f9-4de6-8240-862d4d1fc10e",
                  "name": "The requested resource was not found.",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      },
                      {
                        "description": "Added as a part of security scheme: apikey",
                        "key": "Authorization",
                        "value": "<API Key>"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/abilities/:id",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "abilities",
                        ":id"
                      ],
                      "variable": [
                        {
                          "key": "id"
                        }
                      ]
                    }
                  },
                  "status": "Not Found",
                  "code": 404,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "cookie": [],
                  "responseTime": null,
                  "body": "{\n  \"error\": {\n    \"code\": \"<integer>\",\n    \"message\": \"<string>\",\n    \"errors\": [\n      \"<string>\",\n      \"<string>\"\n    ]\n  }\n}",
                  "createdAt": "2026-07-28T02:30:34.000Z",
                  "updatedAt": "2026-07-28T02:30:34.000Z",
                  "uid": "35240-8b909e97-23f9-4de6-8240-862d4d1fc10e"
                },
                {
                  "id": "8314a153-9bf8-48e4-ad40-443cdc9b59ef",
                  "name": "Too many requests have been made, the rate limit has been reached.",
                  "originalRequest": {
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      },
                      {
                        "description": "Added as a part of security scheme: apikey",
                        "key": "Authorization",
                        "value": "<API Key>"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/abilities/:id",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "abilities",
                        ":id"
                      ],
                      "variable": [
                        {
                          "key": "id"
                        }
                      ]
                    }
                  },
                  "status": "Too Many Requests",
                  "code": 429,
                  "_postman_previewlanguage": "json",
                  "header": [
                    {
                      "key": "Content-Type",
                      "value": "application/json"
                    }
                  ],
                  "cookie": [],
                  "responseTime": null,
                  "body": "{\n  \"error\": {\n    \"code\": \"<integer>\",\n    \"message\": \"<string>\",\n    \"errors\": [\n      \"<string>\",\n      \"<string>\"\n    ]\n  }\n}",
                  "createdAt": "2026-07-28T02:30:34.000Z",
                  "updatedAt": "2026-07-28T02:30:34.000Z",
                  "uid": "35240-8314a153-9bf8-48e4-ad40-443cdc9b59ef"
                }
              ],
              "createdAt": "2026-07-28T02:30:34.000Z",
              "updatedAt": "2026-07-28T02:30:34.000Z",
              "uid": "35240-67b780fa-95de-4cdf-b9ff-9fe31d7d250d"
            }
          ],
          "id": "6faedf7a-c7b7-4fba-b43e-ed9ad0b4bce5",
          "createdAt": "2026-07-28T02:30:34.000Z",
          "updatedAt": "2026-07-28T02:30:34.000Z",
          "uid": "35240-6faedf7a-c7b7-4fba-b43e-ed9ad0b4bce5"
        },
        {
          "name": "PagerDuty List abilities",
          "id": "2462f881-9bf6-4945-ac68-174f47457989",
          "protocolProfileBehavior": {
            "disableBodyPruning": true
          },
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/abilities",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "abilities"
              ]
            },
            "description": "List all of your account's abilities, by name.\n\n\"Abilities\" describes your account's capabilities by feature name. For example `\"teams\"`.\n\nAn ability may be available to your account based on things like your pricing plan or account state.\n\nFor more information see the [API Concepts Document](../../api-reference/ZG9jOjI3NDc5Nzc-api-concepts#abilities)\n\nScoped OAuth requires: `abilities.read`\n"
          },
          "response": [
            {
              "id": "2a6fe9de-e4a9-4d6f-8291-b2405fb4a21a",
              "name": "An array of ability names.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "description": "Added as a part of security scheme: apikey",
                    "key": "Authorization",
                    "value": "<API Key>"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/abilities",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "abilities"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"abilities\": [\n    \"<string>\",\n    \"<string>\"\n  ]\n}",
              "createdAt": "2026-07-28T02:30:34.000Z",
              "updatedAt": "2026-07-28T02:30:34.000Z",
              "uid": "35240-2a6fe9de-e4a9-4d6f-8291-b2405fb4a21a"
            },
            {
              "id": "64aad726-7918-4891-adf6-04babbaa585f",
              "name": "Caller did not supply credentials or did not provide the correct credentials.\nIf you are using an API key, it may be invalid or your Authorization header may be malformed.\n",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "description": "Added as a part of security scheme: apikey",
                    "key": "Authorization",
                    "value": "<API Key>"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/abilities",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "abilities"
                  ]
                }
              },
              "status": "Unauthorized",
              "code": 401,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"error\": {\n    \"code\": \"<integer>\",\n    \"message\": \"<string>\",\n    \"errors\": [\n      \"<string>\",\n      \"<string>\"\n    ]\n  }\n}",
              "createdAt": "2026-07-28T02:30:34.000Z",
              "updatedAt": "2026-07-28T02:30:34.000Z",
              "uid": "35240-64aad726-7918-4891-adf6-04babbaa585f"
            },
            {
              "id": "712cef69-86f2-4d5e-a510-b8eff250642f",
              "name": "Caller is not authorized to view the requested resource.\nWhile your authentication is valid, the authenticated user or token does not have permission to perform this action.\n",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "description": "Added as a part of security scheme: apikey",
                    "key": "Authorization",
                    "value": "<API Key>"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/abilities",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "abilities"
                  ]
                }
              },
              "status": "Forbidden",
              "code": 403,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"error\": {\n    \"code\": \"<integer>\",\n    \"message\": \"<string>\",\n    \"errors\": [\n      \"<string>\",\n      \"<string>\"\n    ]\n  }\n}",
              "createdAt": "2026-07-28T02:30:34.000Z",
              "updatedAt": "2026-07-28T02:30:34.000Z",
              "uid": "35240-712cef69-86f2-4d5e-a510-b8eff250642f"
            },
            {
              "id": "b2bb7866-0944-4fa3-9bea-cc1248d4053e",
              "name": "Too many requests have been made, the rate limit has been reached.",
              "originalRequest": {
                "method": "GET",
                "header": [
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "description": "Added as a part of security scheme: apikey",
                    "key": "Authorization",
                    "value": "<API Key>"
                  }
                ],
                "url": {
                  "raw": "{{baseUrl}}/abilities",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "abilities"
                  ]
                }
              },
              "status": "Too Many Requests",
              "code": 429,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"error\": {\n    \"code\": \"<integer>\",\n    \"message\": \"<string>\",\n    \"errors\": [\n      \"<string>\",\n      \"<string>\"\n    ]\n  }\n}",
              "createdAt": "2026-07-28T02:30:34.000Z",
              "updatedAt": "2026-07-28T02:30:34.000Z",
              "uid": "35240-b2bb7866-0944-4fa3-9bea-cc1248d4053e"
            }
          ],
          "createdAt": "2026-07-28T02:30:34.000Z",
          "updatedAt": "2026-07-28T02:30:34.000Z",
          "uid": "35240-2462f881-9bf6-4945-ac68-174f47457989"
        }
      ],
      "id": "fd2567b3-0e03-4479-8892-82fcf956c28e",
      "createdAt": "2026-07-28T02:30:34.000Z",
      "updatedAt": "2026-07-28T02:30:34.000Z",
      "uid": "35240-fd2567b3-0e03-4479-8892-82fcf956c28e"
    }
  ],
  "auth": {
    "type": "apikey",
    "apikey": [
      {
        "key": "key",
        "value": "Authorization",
        "type": "string"
      },
      {
        "key": "value",
        "value": "{{apiKey}}",
        "type": "string"
      },
      {
        "key": "in",
        "value": "header",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.pagerduty.com"
    }
  ]
}