{
  "info": {
    "_postman_id": "fef24619-88fb-42c4-8e12-332fa53a09a1",
    "name": "PagerDuty Abilities Priorities 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:31:23.000Z",
    "updatedAt": "2026-07-28T02:31:24.000Z",
    "lastUpdatedBy": "35240",
    "uid": "35240-fef24619-88fb-42c4-8e12-332fa53a09a1"
  },
  "item": [
    {
      "name": "priorities",
      "item": [
        {
          "name": "PagerDuty List priorities",
          "id": "6f12d24b-0d7d-44cb-9a9b-2b66da1b5fa2",
          "protocolProfileBehavior": {
            "disableBodyPruning": true
          },
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/priorities?limit=<integer>&offset=<integer>&total=false",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "priorities"
              ],
              "query": [
                {
                  "description": "The number of results per page.",
                  "key": "limit",
                  "value": "<integer>"
                },
                {
                  "description": "Offset to start pagination search results.",
                  "key": "offset",
                  "value": "<integer>"
                },
                {
                  "description": "By default the `total` field in pagination responses is set to `null` to provide the fastest possible response times. Set `total` to `true` for this field to be populated.\n\nSee our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information.\n",
                  "key": "total",
                  "value": "false"
                }
              ]
            },
            "description": "List existing priorities, in order (most to least severe).\n\nA priority is a label representing the importance and impact of an incident. This feature is only available on Standard and Enterprise plans.\n\nFor more information see the [API Concepts Document](../../api-reference/ZG9jOjI3NDc5Nzc-api-concepts#priorities)\n\nScoped OAuth requires: `priorities.read`\n"
          },
          "response": [
            {
              "id": "7ddd2f08-feca-492d-8267-2c560f468ef8",
              "name": "A paginated array of priorities.",
              "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}}/priorities?limit=<integer>&offset=<integer>&total=false",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "priorities"
                  ],
                  "query": [
                    {
                      "description": "The number of results per page.",
                      "key": "limit",
                      "value": "<integer>"
                    },
                    {
                      "description": "Offset to start pagination search results.",
                      "key": "offset",
                      "value": "<integer>"
                    },
                    {
                      "description": "By default the `total` field in pagination responses is set to `null` to provide the fastest possible response times. Set `total` to `true` for this field to be populated.\n\nSee our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information.\n",
                      "key": "total",
                      "value": "false"
                    }
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"priorities\": [\n    {\n      \"id\": \"<string>\",\n      \"summary\": \"<string>\",\n      \"type\": \"<string>\",\n      \"self\": \"<string>\",\n      \"html_url\": \"<string>\",\n      \"name\": \"<string>\",\n      \"description\": \"<string>\"\n    },\n    {\n      \"id\": \"<string>\",\n      \"summary\": \"<string>\",\n      \"type\": \"<string>\",\n      \"self\": \"<string>\",\n      \"html_url\": \"<string>\",\n      \"name\": \"<string>\",\n      \"description\": \"<string>\"\n    }\n  ],\n  \"offset\": \"<integer>\",\n  \"limit\": \"<integer>\",\n  \"more\": \"<boolean>\",\n  \"total\": \"<integer>\"\n}",
              "createdAt": "2026-07-28T02:31:24.000Z",
              "updatedAt": "2026-07-28T02:31:24.000Z",
              "uid": "35240-7ddd2f08-feca-492d-8267-2c560f468ef8"
            },
            {
              "id": "bfa374ec-41e8-4655-9154-9f8ee43ff93f",
              "name": "Caller provided invalid arguments. Please review the response for error details. Retrying with the same arguments will *not* work.",
              "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}}/priorities?limit=<integer>&offset=<integer>&total=false",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "priorities"
                  ],
                  "query": [
                    {
                      "description": "The number of results per page.",
                      "key": "limit",
                      "value": "<integer>"
                    },
                    {
                      "description": "Offset to start pagination search results.",
                      "key": "offset",
                      "value": "<integer>"
                    },
                    {
                      "description": "By default the `total` field in pagination responses is set to `null` to provide the fastest possible response times. Set `total` to `true` for this field to be populated.\n\nSee our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information.\n",
                      "key": "total",
                      "value": "false"
                    }
                  ]
                }
              },
              "status": "Bad Request",
              "code": 400,
              "_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:31:24.000Z",
              "updatedAt": "2026-07-28T02:31:24.000Z",
              "uid": "35240-bfa374ec-41e8-4655-9154-9f8ee43ff93f"
            },
            {
              "id": "c29b547e-8169-4a27-ad11-00ee41626262",
              "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}}/priorities?limit=<integer>&offset=<integer>&total=false",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "priorities"
                  ],
                  "query": [
                    {
                      "description": "The number of results per page.",
                      "key": "limit",
                      "value": "<integer>"
                    },
                    {
                      "description": "Offset to start pagination search results.",
                      "key": "offset",
                      "value": "<integer>"
                    },
                    {
                      "description": "By default the `total` field in pagination responses is set to `null` to provide the fastest possible response times. Set `total` to `true` for this field to be populated.\n\nSee our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information.\n",
                      "key": "total",
                      "value": "false"
                    }
                  ]
                }
              },
              "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:31:24.000Z",
              "updatedAt": "2026-07-28T02:31:24.000Z",
              "uid": "35240-c29b547e-8169-4a27-ad11-00ee41626262"
            },
            {
              "id": "2defda61-50e2-4def-851b-7002cc117b2f",
              "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}}/priorities?limit=<integer>&offset=<integer>&total=false",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "priorities"
                  ],
                  "query": [
                    {
                      "description": "The number of results per page.",
                      "key": "limit",
                      "value": "<integer>"
                    },
                    {
                      "description": "Offset to start pagination search results.",
                      "key": "offset",
                      "value": "<integer>"
                    },
                    {
                      "description": "By default the `total` field in pagination responses is set to `null` to provide the fastest possible response times. Set `total` to `true` for this field to be populated.\n\nSee our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information.\n",
                      "key": "total",
                      "value": "false"
                    }
                  ]
                }
              },
              "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:31:24.000Z",
              "updatedAt": "2026-07-28T02:31:24.000Z",
              "uid": "35240-2defda61-50e2-4def-851b-7002cc117b2f"
            },
            {
              "id": "d51fb58b-410c-4e70-95d9-9523490e2696",
              "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}}/priorities?limit=<integer>&offset=<integer>&total=false",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "priorities"
                  ],
                  "query": [
                    {
                      "description": "The number of results per page.",
                      "key": "limit",
                      "value": "<integer>"
                    },
                    {
                      "description": "Offset to start pagination search results.",
                      "key": "offset",
                      "value": "<integer>"
                    },
                    {
                      "description": "By default the `total` field in pagination responses is set to `null` to provide the fastest possible response times. Set `total` to `true` for this field to be populated.\n\nSee our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information.\n",
                      "key": "total",
                      "value": "false"
                    }
                  ]
                }
              },
              "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:31:24.000Z",
              "updatedAt": "2026-07-28T02:31:24.000Z",
              "uid": "35240-d51fb58b-410c-4e70-95d9-9523490e2696"
            },
            {
              "id": "e35fc108-08c1-4002-9d15-15b5983d189b",
              "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}}/priorities?limit=<integer>&offset=<integer>&total=false",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "priorities"
                  ],
                  "query": [
                    {
                      "description": "The number of results per page.",
                      "key": "limit",
                      "value": "<integer>"
                    },
                    {
                      "description": "Offset to start pagination search results.",
                      "key": "offset",
                      "value": "<integer>"
                    },
                    {
                      "description": "By default the `total` field in pagination responses is set to `null` to provide the fastest possible response times. Set `total` to `true` for this field to be populated.\n\nSee our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information.\n",
                      "key": "total",
                      "value": "false"
                    }
                  ]
                }
              },
              "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:31:24.000Z",
              "updatedAt": "2026-07-28T02:31:24.000Z",
              "uid": "35240-e35fc108-08c1-4002-9d15-15b5983d189b"
            }
          ],
          "createdAt": "2026-07-28T02:31:24.000Z",
          "updatedAt": "2026-07-28T02:31:24.000Z",
          "uid": "35240-6f12d24b-0d7d-44cb-9a9b-2b66da1b5fa2"
        }
      ],
      "id": "f5838823-7f22-4e68-9a1e-efd5a073c0da",
      "createdAt": "2026-07-28T02:31:24.000Z",
      "updatedAt": "2026-07-28T02:31:24.000Z",
      "uid": "35240-f5838823-7f22-4e68-9a1e-efd5a073c0da"
    }
  ],
  "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"
    }
  ]
}