---
title: Pagerduty
slug: connectors/pagerduty
docTags: 
createdAt: 2026-06-09T16:30:10.799Z
---

PagerDuty is an incident management platform designed to alert and empower teams to resolve critical issues efficiently.

PagerDuty is a leading incident management platform that empowers teams to quickly respond to critical issues. This connector allows Swimlane Turbine users to seamlessly integrate with PagerDuty, enabling automated incident creation, retrieval, and management. By leveraging this integration, users can enhance their incident response capabilities, streamline operations, and ensure timely resolution of incidents, all without writing a single line of code.

### Limitations

- None to date.

### Supported Versions

- This PagerDuty connector uses the v2 API.

### Additional Documents

- Documentation [PagerDuty API Reference](https://developer.pagerduty.com/api-reference/e65c5833eeb07-pager-duty-api)

## Configuration

### Prerequisites

Before you can use the PagerDuty connector for Turbine, you'll need access to the PagerDuty API. This requires the following:

- an API key authentication using the following parameters:
  - URL: The endpoint URL for accessing PagerDuty's API.
  - API Key: A unique key provided by PagerDuty to authenticate API requests.

## Authentication Methods

- URL: The endpoint URL for accessing the PagerDuty API.
- API Key: A token used to authenticate API requests securely, sent as `Token token=<apikey>` in the Authorization header.

## Capabilities

This PagerDuty connector provides the following capabilities:

- Create an Incident
- Get a Log Entry
- Get an Alert
- Get an Incident
- Get a User
- List Alerts for an Incident
- List Escalation Policies
- List Incidents
- List Log Entries
- List Notes for an Incident
- List On Calls
- List Services
- List Teams
- List Users

### Create an Incident

- Create an incident synchronously without a corresponding event from a monitoring service [Click Here](https://developer.pagerduty.com/api-reference/a7d81b0e9200f-create-an-incident).

### Get a Log Entry

- Get details for a specific incident log entry [Click Here](https://developer.pagerduty.com/api-reference/3f6cc44614c5f-get-a-log-entry).

### Get an Alert

- Get details for a single alert on a specified incident [Click Here](https://developer.pagerduty.com/api-reference/7bdb05c4dfc86-get-an-alert).

### Get an Incident

- Get details for a single incident by ID [Click Here](https://developer.pagerduty.com/api-reference/0a855c5f4f64d-get-an-incident).

### Get a User

- Get details about an existing user, optionally including contact methods, notification rules, and teams [Click Here](https://developer.pagerduty.com/api-reference/get-a-user).

### List Alerts for an Incident

- List alerts for a specified incident [Click Here](https://developer.pagerduty.com/api-reference/072a97d9ea35e-list-alerts-for-an-incident).

### List Escalation Policies

- List all escalation policies, with optional filters by name or team [Click Here](https://developer.pagerduty.com/api-reference/72b50ef3c6729-list-escalation-policies).

### List Incidents

- List existing incidents, with a broad set of filters available for narrowing results [Click Here](https://developer.pagerduty.com/api-reference/9d0b4b12e36f9-list-incidents).

### List Log Entries

- List all incident log entries across the entire account [Click Here](https://developer.pagerduty.com/api-reference/db3cbce4ff6fb-list-log-entries).

### List Notes for an Incident

- List existing notes for a specified incident [Click Here](https://developer.pagerduty.com/api-reference/list-incident-notes).

### List On Calls

- List the on-call entries during a given time range [Click Here](https://developer.pagerduty.com/api-reference/a4417a2c4ab27-list-on-calls).

### List Services

- List existing services, with optional filters by team or name [Click Here](https://developer.pagerduty.com/api-reference/e3a2d06f62fa8-list-services).

### List Teams

- List teams of your PagerDuty account, optionally filtered by name [Click Here](https://developer.pagerduty.com/api-reference/1a51b93f3c37a-list-teams).

### List Users

- List users of your PagerDuty account, optionally filtered by name [Click Here](https://developer.pagerduty.com/api-reference/0aeacf7d9bf34-list-users).

# Configurations

## API Key Authentication

Authenticates using an API Key

### Configuration Parameters

| **Parameter** | **Description**                                                                   | **Type** | **Required** |
| ------------- | --------------------------------------------------------------------------------- | -------- | ------------ |
| url           | A URL to the target host.                                                         | string   | Required     |
| apikey        | API key in the authorization header of all requests that are sent to API Gateway. | string   | Required     |
| verify\_ssl   | Verify SSL certificate                                                            | boolean  | Optional     |
| http\_proxy   | A proxy to route requests through.                                                | string   | Optional     |

# Actions

## Create an Incident

Create an incident in PagerDuty synchronously without a corresponding event from a monitoring service. Requires JSON body with incident details and headers.

### Endpoint

- **URL:** `/incidents`
- **Method:** `POST`

### Input

| **Argument Name**                    | **Type** | **Required** | **Description**              |
| ------------------------------------ | -------- | ------------ | ---------------------------- |
| `headers`                            | object   | Required     | HTTP headers for the request |
| `headers.Accept`                     | string   | Required     | HTTP headers for the request |
| `headers.Content-Type`               | string   | Required     | HTTP headers for the request |
| `headers.From`                       | string   | Required     | HTTP headers for the request |
| `incident`                           | object   | Optional     | Unique identifier            |
| `incident.type`                      | string   | Required     | Unique identifier            |
| `incident.title`                     | string   | Required     | Unique identifier            |
| `incident.service`                   | object   | Required     | Unique identifier            |
| `incident.service.id`                | string   | Optional     | Unique identifier            |
| `incident.service.type`              | string   | Optional     | Unique identifier            |
| `incident.priority`                  | object   | Optional     | Unique identifier            |
| `incident.priority.id`               | string   | Optional     | Unique identifier            |
| `incident.priority.type`             | string   | Optional     | Unique identifier            |
| `incident.urgency`                   | string   | Optional     | Unique identifier            |
| `incident.body`                      | object   | Optional     | Request body data            |
| `incident.body.type`                 | string   | Optional     | Request body data            |
| `incident.body.details`              | string   | Optional     | Request body data            |
| `incident.incident_key`              | string   | Optional     | Unique identifier            |
| `incident.assignments`               | array    | Optional     | Unique identifier            |
| `incident.assignments.assignee`      | object   | Optional     | Unique identifier            |
| `incident.assignments.assignee.type` | string   | Optional     | Unique identifier            |
| `incident.escalation_policy`         | object   | Optional     | Unique identifier            |
| `incident.escalation_policy.id`      | string   | Optional     | Unique identifier            |
| `incident.escalation_policy.type`    | string   | Optional     | Unique identifier            |
| `incident.conference_bridge`         | object   | Optional     | Unique identifier            |

### Input Example

`{"json_body":{"incident":{"type":"incident","title":"The server is on fire.","service":{"id":"PWIXJZS","type":"service_reference"},"priority":{"id":"P53ZZH5","type":"priority_reference"},"urgency":"high","body":{"type":"incident_body","details":"A disk is getting full on this machine. You should investigate what is causing the disk to fill, and ensure that there is an automated process in place for ensuring data is rotated (eg. logs should have logrotate around them). If data is expected to stay on this disk forever, you should start planning to scale up to a larger disk."},"incident_key":"baf7cf21b1da41b4b0221008339ff357","assignments":[{"assignee":{"type":"service_reference"}},{"assignee":{"type":"priority_reference"}}],"escalation_policy":{"id":"PT20YPA","type":"escalation_policy_reference"},"conference_bridge":{"conference_number":"+1 415-555-1212","conference_url":"https://subdomain.pagerduty.com"}}},"headers":{"Accept":"application/vnd.pagerduty+json;version=2","Content-Type":"application/json","From":"Mail ID"}}`

### Output

| **Parameter**               | **Type** | **Description**                  |
| --------------------------- | -------- | -------------------------------- |
| `status_code`               | number   | HTTP status code of the response |
| `reason`                    | string   | Response reason phrase           |
| `incident`                  | object   | Unique identifier                |
| `incident.id`               | string   | Unique identifier                |
| `incident.type`             | string   | Unique identifier                |
| `incident.title`            | string   | Unique identifier                |
| `incident.summary`          | string   | Unique identifier                |
| `incident.self`             | string   | Unique identifier                |
| `incident.html_url`         | string   | URL endpoint for the request     |
| `incident.incident_number`  | number   | Unique identifier                |
| `incident.created_at`       | string   | Unique identifier                |
| `incident.updated_at`       | string   | Unique identifier                |
| `incident.status`           | string   | Unique identifier                |
| `incident.incident_key`     | string   | Unique identifier                |
| `incident.service`          | object   | Unique identifier                |
| `incident.service.id`       | string   | Unique identifier                |
| `incident.service.type`     | string   | Unique identifier                |
| `incident.service.summary`  | string   | Unique identifier                |
| `incident.service.self`     | string   | Unique identifier                |
| `incident.service.html_url` | string   | URL endpoint for the request     |
| `incident.priority`         | object   | Unique identifier                |
| `incident.priority.id`      | string   | Unique identifier                |
| `incident.priority.type`    | string   | Unique identifier                |
| `incident.priority.summary` | string   | Unique identifier                |
| `incident.priority.self`    | string   | Unique identifier                |

### Output Example

`{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"incident":{"id":"PT4KHLK","type":"incident","title":"The server is on fire.","summary":"[#1234] The server is on fire.","self":"https://api.pagerduty.com/incidents/PT4KHLK","html_url":"https://subdomain.pagerduty.com/incidents/PT4KHLK","incident_number":1234,"created_at":"2015-10-06T21:30:42Z","updated_at":"2015-10-06T21:40:23Z","status":"triggered","incident_key":"baf7cf21b1da41b4b0221008339ff357","service":{},"priority":{},"a...`

## List Escalation Policies

Retrieve a list of all existing escalation policies in PagerDuty. Requires headers for authentication.

### Endpoint

- **URL:** `/escalation_policies`
- **Method:** `GET`

### Input

| **Argument Name**       | **Type** | **Required** | **Description**                                    |
| ----------------------- | -------- | ------------ | -------------------------------------------------- |
| `parameters.limit`      | number   | Optional     | Parameters for the List Escalation Policies action |
| `parameters.offset`     | number   | Optional     | Parameters for the List Escalation Policies action |
| `parameters.total`      | boolean  | Optional     | Parameters for the List Escalation Policies action |
| `parameters.query`      | string   | Optional     | Parameters for the List Escalation Policies action |
| `parameters.include[]`  | string   | Optional     | Parameters for the List Escalation Policies action |
| `parameters.sort_by`    | string   | Optional     | Parameters for the List Escalation Policies action |
| `parameters.team_ids[]` | array    | Optional     | Parameters for the List Escalation Policies action |
| `parameters.user_ids[]` | array    | Optional     | Parameters for the List Escalation Policies action |
| `headers`               | object   | Required     | HTTP headers for the request                       |
| `headers.Accept`        | string   | Required     | HTTP headers for the request                       |
| `headers.Content-Type`  | string   | Required     | HTTP headers for the request                       |

### Input Example

`{"parameters":{"limit":25,"offset":0,"total":false,"query":"","include[]":"teams","sort_by":"name","team_ids[]":["PQ9K7I8"],"user_ids[]":["PI7DH85"]},"headers":{"Accept":"application/vnd.pagerduty+json;version=2","Content-Type":"application/json"}}`

### Output

| **Parameter**                                                      | **Type** | **Description**                                                                     |
| ------------------------------------------------------------------ | -------- | ----------------------------------------------------------------------------------- |
| `status_code`                                                      | number   | HTTP status code of the response                                                    |
| `reason`                                                           | string   | Response reason phrase                                                              |
| `escalation_policies`                                              | array    | Output field: escalation\_policies                                                  |
| `escalation_policies.id`                                           | string   | Unique identifier                                                                   |
| `escalation_policies.type`                                         | string   | Type of the resource                                                                |
| `escalation_policies.summary`                                      | string   | Output field: escalation\_policies.summary                                          |
| `escalation_policies.self`                                         | string   | Output field: escalation\_policies.self                                             |
| `escalation_policies.html_url`                                     | string   | URL endpoint for the request                                                        |
| `escalation_policies.name`                                         | string   | Name of the resource                                                                |
| `escalation_policies.escalation_rules`                             | array    | Output field: escalation\_policies.escalation\_rules                                |
| `escalation_policies.escalation_rules.id`                          | string   | Unique identifier                                                                   |
| `escalation_policies.escalation_rules.escalation_delay_in_minutes` | number   | Output field: escalation\_policies.escalation\_rules.escalation\_delay\_in\_minutes |
| `escalation_policies.escalation_rules.targets`                     | array    | Output field: escalation\_policies.escalation\_rules.targets                        |
| `escalation_policies.escalation_rules.targets.id`                  | string   | Unique identifier                                                                   |
| `escalation_policies.escalation_rules.targets.type`                | string   | Type of the resource                                                                |
| `escalation_policies.escalation_rules.targets.summary`             | string   | Output field: escalation\_policies.escalation\_rules.targets.summary                |
| `escalation_policies.escalation_rules.targets.self`                | string   | Output field: escalation\_policies.escalation\_rules.targets.self                   |
| `escalation_policies.escalation_rules.targets.html_url`            | string   | URL endpoint for the request                                                        |
| `escalation_policies.services`                                     | array    | Output field: escalation\_policies.services                                         |
| `escalation_policies.services.id`                                  | string   | Unique identifier                                                                   |
| `escalation_policies.services.type`                                | string   | Type of the resource                                                                |
| `escalation_policies.services.summary`                             | string   | Output field: escalation\_policies.services.summary                                 |
| `escalation_policies.services.self`                                | string   | Output field: escalation\_policies.services.self                                    |
| `escalation_policies.services.html_url`                            | string   | URL endpoint for the request                                                        |
| `escalation_policies.num_loops`                                    | number   | Output field: escalation\_policies.num\_loops                                       |

### Output Example

`{"status_code":200,"response_headers":{"Server":"nginx","Date":"Fri, 10 Nov 2023 07:39:08 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","Vary":"Accept-Encoding, Accept","Access-Control-Allow-Origin":"*","x-frame-options":"SAMEORIGIN","x-xss-protection":"1; mode=block, 1; mode=block","x-content-type-options":"nosniff, nosniff","x-download-options":"noopen","x-permitted-cross-domain-policies":"none","referrer-policy":"strict-origin-when-cross-origin...`

## Get an Incident

Get details for a single incident in PagerDuty using the incident ID. Requires parameters, headers, and path parameters.

### Endpoint

- **URL:** `/incidents/{{id}}`
- **Method:** `GET`

### Input

| **Argument Name**      | **Type** | **Required** | **Description**                           |
| ---------------------- | -------- | ------------ | ----------------------------------------- |
| `path_parameters.id`   | string   | Required     | Parameters for the Get an Incident action |
| `parameters.include[]` | string   | Optional     | Parameters for the Get an Incident action |
| `headers`              | object   | Required     | HTTP headers for the request              |
| `headers.Accept`       | string   | Required     | HTTP headers for the request              |
| `headers.Content-Type` | string   | Required     | HTTP headers for the request              |

### Input Example

`{"parameters":{"id":"PT4KHLK","include[]":"users"},"path_parameters":{"id":"PT4KHLK"},"headers":{"Accept":"application/vnd.pagerduty+json;version=2","Content-Type":"application/json"}}`

### Output

| **Parameter**                        | **Type** | **Description**                  |
| ------------------------------------ | -------- | -------------------------------- |
| `status_code`                        | number   | HTTP status code of the response |
| `reason`                             | string   | Response reason phrase           |
| `incident`                           | object   | Unique identifier                |
| `incident.id`                        | string   | Unique identifier                |
| `incident.type`                      | string   | Unique identifier                |
| `incident.summary`                   | string   | Unique identifier                |
| `incident.self`                      | string   | Unique identifier                |
| `incident.html_url`                  | string   | URL endpoint for the request     |
| `incident.incident_number`           | number   | Unique identifier                |
| `incident.title`                     | string   | Unique identifier                |
| `incident.created_at`                | string   | Unique identifier                |
| `incident.updated_at`                | string   | Unique identifier                |
| `incident.status`                    | string   | Unique identifier                |
| `incident.incident_key`              | string   | Unique identifier                |
| `incident.service`                   | object   | Unique identifier                |
| `incident.service.id`                | string   | Unique identifier                |
| `incident.service.type`              | string   | Unique identifier                |
| `incident.service.summary`           | string   | Unique identifier                |
| `incident.service.self`              | string   | Unique identifier                |
| `incident.service.html_url`          | string   | URL endpoint for the request     |
| `incident.assignments`               | array    | Unique identifier                |
| `incident.assignments.at`            | string   | Unique identifier                |
| `incident.assignments.assignee`      | object   | Unique identifier                |
| `incident.assignments.assignee.id`   | string   | Unique identifier                |
| `incident.assignments.assignee.type` | string   | Unique identifier                |

### Output Example

`{"incident":{"id":"12345678-1234-1234-1234-123456789abc","type":"string","summary":"string","self":"string","html_url":"string","incident_number":123,"title":"string","created_at":"string","updated_at":"string","status":"active","incident_key":"string","service":{"id":"12345678-1234-1234-1234-123456789abc","type":"string","summary":"string","self":"string","html_url":"string"},"assignments":[{}],"assigned_via":"string","last_status_change_at":"active"}}`

## Get an Alert

Get detailed information for a specific alert using incident ID and alert ID in PagerDuty. Requires OAuth scope incidents.read.

### Endpoint

- **URL:** `/incidents/{{id}}/alerts/{{alert_id}}`
- **Method:** `GET`

### Input

| **Argument Name**          | **Type** | **Required** | **Description**                                                     |
| -------------------------- | -------- | ------------ | ------------------------------------------------------------------- |
| `path_parameters.id`       | string   | Required     | The ID of the incident resource.                                    |
| `path_parameters.alert_id` | string   | Required     | The id of the alert to retrieve.                                    |
| `headers`                  | object   | Required     | HTTP headers for the request                                        |
| `headers.Accept`           | string   | Required     | Versioning header. Default application/vnd.pagerduty+json;version=2 |
| `headers.Content-Type`     | string   | Required     | Allowed value application/json.                                     |

### Input Example

`{"path_parameters":{"id":"PT4KHLX","alert_id":"PT4KHLK"},"headers":{"Accept":"application/vnd.pagerduty+json;version=2","Content-Type":"application/json"}}`

### Output

| **Parameter**                   | **Type** | **Description**                                                                                     |
| ------------------------------- | -------- | --------------------------------------------------------------------------------------------------- |
| `status_code`                   | number   | HTTP status code of the response                                                                    |
| `reason`                        | string   | Response reason phrase                                                                              |
| `alert`                         | object   | Output field: alert                                                                                 |
| `alert.id`                      | string   | Unique identifier                                                                                   |
| `alert.summary`                 | string   | Short-form server-generated label for the object.                                                   |
| `alert.type`                    | string   | The type of object. Allowed value alert.                                                            |
| `alert.self`                    | string   | API URL for this object.                                                                            |
| `alert.html_url`                | string   | URL where the entity is shown in the web app.                                                       |
| `alert.created_at`              | string   | When the alert was first triggered.                                                                 |
| `alert.status`                  | string   | Current alert status (e.g. triggered or resolved).                                                  |
| `alert.alert_key`               | string   | The alert's de-duplication key.                                                                     |
| `alert.service`                 | object   | Output field: alert.service                                                                         |
| `alert.first_trigger_log_entry` | object   | Output field: alert.first\_trigger\_log\_entry                                                      |
| `alert.incident`                | object   | Unique identifier                                                                                   |
| `alert.suppressed`              | boolean  | Whether the alert is suppressed (not created with a parent incident).                               |
| `alert.severity`                | string   | Magnitude as reported by the monitoring tool.                                                       |
| `alert.integration`             | object   | Output field: alert.integration                                                                     |
| `alert.body`                    | object   | JSON describing the alert (e.g. alert\_body with contexts such as link entries and details fields). |

### Output Example

`{"alert":{"id":"12345678-1234-1234-1234-123456789abc","summary":"string","type":"string","self":"string","html_url":"string","created_at":"string","status":"active","alert_key":"string","service":{},"first_trigger_log_entry":{},"incident":{},"suppressed":true,"severity":"string","integration":{},"body":{}}}`

## List Alerts for an Incident

List alerts for a specified incident in PagerDuty. Requires OAuth scope incidents.read and the incident ID as a path parameter.

### Endpoint

- **URL:** `/incidents/{{id}}/alerts`
- **Method:** `GET`

### Input

| **Argument Name**      | **Type** | **Required** | **Description**                                                                                                                                                                                                                                             |
| ---------------------- | -------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path_parameters.id`   | string   | Required     | The ID of the incident resource.                                                                                                                                                                                                                            |
| `parameters.limit`     | number   | Optional     | The number of results per page.                                                                                                                                                                                                                             |
| `parameters.offset`    | number   | Optional     | Offset to start pagination search results.                                                                                                                                                                                                                  |
| `parameters.total`     | boolean  | Optional     | When true, populates the total field in pagination responses. Default is false for faster responses.                                                                                                                                                        |
| `parameters.alert_key` | string   | Optional     | Alert de-duplication key.                                                                                                                                                                                                                                   |
| `parameters.include`   | string   | Optional     | Additional details to include. Allowed values are services, first\_trigger\_log\_entries, incidents.                                                                                                                                                        |
| `parameters.sort_by`   | string   | Optional     | Field and direction to sort on (created\_at or resolved\_at, asc or desc). Use field\:direction; up to two fields, comma-separated. Examples include created\_at, resolved\_at, created\_at\:asc, created\_at\:desc, resolved\_at\:asc, resolved\_at\:desc. |
| `parameters.statuses`  | array    | Optional     | Return only alerts with the given statuses.                                                                                                                                                                                                                 |
| `headers`              | object   | Required     | HTTP headers for the request                                                                                                                                                                                                                                |
| `headers.Accept`       | string   | Required     | Versioning header. Default application/vnd.pagerduty+json;version=2                                                                                                                                                                                         |
| `headers.Content-Type` | string   | Required     | Allowed value application/json.                                                                                                                                                                                                                             |

### Input Example

`{"parameters":{"limit":25,"offset":0,"total":false,"sort_by":"created_at:desc"},"path_parameters":{"id":"PT4KHLK"},"headers":{"Accept":"application/vnd.pagerduty+json;version=2","Content-Type":"application/json"}}`

### Output

| **Parameter**                    | **Type** | **Description**                                                         |
| -------------------------------- | -------- | ----------------------------------------------------------------------- |
| `status_code`                    | number   | HTTP status code of the response                                        |
| `reason`                         | string   | Response reason phrase                                                  |
| `offset`                         | number   | Echoes offset pagination property.                                      |
| `limit`                          | number   | Echoes limit pagination property.                                       |
| `more`                           | boolean  | Indicates if there are additional records to return.                    |
| `total`                          | object   | Total number of records matching the query, or null when not requested. |
| `alerts`                         | array    | Output field: alerts                                                    |
| `alerts.id`                      | string   | Unique identifier                                                       |
| `alerts.summary`                 | string   | Short-form server-generated label for the object.                       |
| `alerts.type`                    | string   | The type of object. Allowed value alert.                                |
| `alerts.self`                    | string   | API URL for this object.                                                |
| `alerts.html_url`                | string   | URL where the entity is shown in the web app.                           |
| `alerts.created_at`              | string   | When the alert was first triggered.                                     |
| `alerts.status`                  | string   | Current alert status.                                                   |
| `alerts.alert_key`               | string   | The alert's de-duplication key.                                         |
| `alerts.service`                 | object   | Output field: alerts.service                                            |
| `alerts.first_trigger_log_entry` | object   | Output field: alerts.first\_trigger\_log\_entry                         |
| `alerts.incident`                | object   | Unique identifier                                                       |
| `alerts.suppressed`              | boolean  | Whether the alert is suppressed (not created with a parent incident).   |
| `alerts.severity`                | string   | Magnitude as reported by the monitoring tool.                           |
| `alerts.integration`             | object   | Output field: alerts.integration                                        |
| `alerts.body`                    | object   | JSON object describing the alert.                                       |

### Output Example

`{"offset":123,"limit":123,"more":true,"total":{},"alerts":[{"id":"12345678-1234-1234-1234-123456789abc","summary":"string","type":"string","self":"string","html_url":"string","created_at":"string","status":"active","alert_key":"string","service":{},"first_trigger_log_entry":{},"incident":{},"suppressed":true,"severity":"string","integration":{},"body":{}}]}`

## List Incidents

Retrieve a list of incidents from PagerDuty, with optional filters such as status, service, team, user, and time range. Requires headers for authentication.

### Endpoint

- **URL:** `/incidents`
- **Method:** `GET`

### Input

| **Argument Name**           | **Type** | **Required** | **Description**                          |
| --------------------------- | -------- | ------------ | ---------------------------------------- |
| `parameters.limit`          | number   | Optional     | Parameters for the List Incidents action |
| `parameters.offset`         | number   | Optional     | Parameters for the List Incidents action |
| `parameters.total`          | boolean  | Optional     | Parameters for the List Incidents action |
| `parameters.since`          | string   | Optional     | Parameters for the List Incidents action |
| `parameters.until`          | string   | Optional     | Parameters for the List Incidents action |
| `parameters.date_range`     | string   | Optional     | Parameters for the List Incidents action |
| `parameters.incident_key`   | string   | Optional     | Parameters for the List Incidents action |
| `parameters.statuses[]`     | array    | Optional     | Parameters for the List Incidents action |
| `parameters.service_ids[]`  | array    | Optional     | Parameters for the List Incidents action |
| `parameters.team_ids[]`     | array    | Optional     | Parameters for the List Incidents action |
| `parameters.user_ids[]`     | array    | Optional     | Parameters for the List Incidents action |
| `parameters.urgencies[]`    | array    | Optional     | Parameters for the List Incidents action |
| `parameters.include[]`      | string   | Optional     | Parameters for the List Incidents action |
| `parameters.sort_by`        | string   | Optional     | Parameters for the List Incidents action |
| `parameters.sort_direction` | string   | Optional     | Parameters for the List Incidents action |
| `headers`                   | object   | Required     | HTTP headers for the request             |
| `headers.Accept`            | string   | Required     | HTTP headers for the request             |
| `headers.Content-Type`      | string   | Required     | HTTP headers for the request             |

### Input Example

`{"parameters":{"limit":25,"offset":0,"total":false,"statuses[]":["triggered"],"include[]":"users"},"headers":{"Accept":"application/vnd.pagerduty+json;version=2","Content-Type":"application/json"}}`

### Output

| **Parameter**                     | **Type** | **Description**                  |
| --------------------------------- | -------- | -------------------------------- |
| `status_code`                     | number   | HTTP status code of the response |
| `reason`                          | string   | Response reason phrase           |
| `incidents`                       | array    | Unique identifier                |
| `incidents.id`                    | string   | Unique identifier                |
| `incidents.type`                  | string   | Unique identifier                |
| `incidents.summary`               | string   | Unique identifier                |
| `incidents.self`                  | string   | Unique identifier                |
| `incidents.html_url`              | string   | URL endpoint for the request     |
| `incidents.incident_number`       | number   | Unique identifier                |
| `incidents.title`                 | string   | Unique identifier                |
| `incidents.created_at`            | string   | Unique identifier                |
| `incidents.updated_at`            | string   | Unique identifier                |
| `incidents.status`                | string   | Unique identifier                |
| `incidents.incident_key`          | string   | Unique identifier                |
| `incidents.service`               | object   | Unique identifier                |
| `incidents.service.id`            | string   | Unique identifier                |
| `incidents.service.type`          | string   | Unique identifier                |
| `incidents.service.summary`       | string   | Unique identifier                |
| `incidents.service.self`          | string   | Unique identifier                |
| `incidents.service.html_url`      | string   | URL endpoint for the request     |
| `incidents.assignments`           | array    | Unique identifier                |
| `incidents.assignments.file_name` | string   | Unique identifier                |
| `incidents.assignments.file`      | string   | Unique identifier                |
| `incidents.assigned_via`          | string   | Unique identifier                |
| `incidents.last_status_change_at` | string   | Unique identifier                |

### Output Example

`{"status_code":200,"reason":"OK","json_body":{"incidents":[{}],"limit":1,"offset":0,"more":true}}`

## List Log Entries

Retrieve a list of incident log entries across the entire PagerDuty account. Requires OAuth scope incidents.read and includes parameters and headers for access.

### Endpoint

- **URL:** `/log_entries`
- **Method:** `GET`

### Input

| **Argument Name**        | **Type** | **Required** | **Description**                                                                                                     |
| ------------------------ | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------- |
| `parameters.is_overview` | boolean  | Optional     | If true, returns a subset of log entries showing only the most important changes to the incident. Default is false. |
| `parameters.limit`       | number   | Optional     | The number of results per page.                                                                                     |
| `parameters.offset`      | number   | Optional     | Offset to start pagination search results.                                                                          |
| `parameters.total`       | boolean  | Optional     | When true, populates the total field in pagination responses. Default is false for faster responses.                |
| `parameters.include`     | string   | Optional     | Additional models to include. Allowed values are incidents, services, channels, and teams.                          |
| `parameters.since`       | string   | Optional     | Start of the date-time range to search.                                                                             |
| `parameters.until`       | string   | Optional     | End of the date-time range to search.                                                                               |
| `parameters.team_ids`    | array    | Optional     | Only results related to these teams are returned. The account must have the teams ability to use this parameter.    |
| `parameters.time_zone`   | string   | Optional     | Time zone in which results are rendered; defaults to the account time zone.                                         |
| `headers`                | object   | Required     | HTTP headers for the request                                                                                        |
| `headers.Accept`         | string   | Required     | Versioning header. Default application/vnd.pagerduty+json;version=2                                                 |
| `headers.Content-Type`   | string   | Required     | Allowed value application/json.                                                                                     |

### Input Example

`{"parameters":{"limit":1,"offset":0,"total":false,"is_overview":false,"include":"incidents","team_ids":["PQ9K7I8"],"time_zone":"America/Los_Angeles"},"headers":{"Accept":"application/vnd.pagerduty+json;version=2","Content-Type":"application/json"}}`

### Output

| **Parameter**                         | **Type** | **Description**                                                                                     |
| ------------------------------------- | -------- | --------------------------------------------------------------------------------------------------- |
| `status_code`                         | number   | HTTP status code of the response                                                                    |
| `reason`                              | string   | Response reason phrase                                                                              |
| `offset`                              | number   | Echoes offset pagination property.                                                                  |
| `limit`                               | number   | Echoes limit pagination property.                                                                   |
| `more`                                | boolean  | Indicates if there are additional records to return.                                                |
| `total`                               | object   | Total number of records matching the query, or null when not requested.                             |
| `log_entries`                         | array    | Polymorphic list; each item type (e.g. TriggerLogEntry, AcknowledgeLogEntry) has a distinct schema. |
| `log_entries.acknowledgement_timeout` | number   | Duration for which the acknowledgement lasts, in seconds; may be absent or null on older entries.   |
| `log_entries.type`                    | string   | Entity type name (e.g. trigger\_log\_entry).                                                        |
| `log_entries.id`                      | string   | Unique identifier                                                                                   |
| `log_entries.summary`                 | string   | Short-form server-generated label for the object.                                                   |
| `log_entries.self`                    | string   | API URL for this object.                                                                            |
| `log_entries.html_url`                | string   | URL where the entity is shown in the web app.                                                       |
| `log_entries.created_at`              | string   | When the log entry was created.                                                                     |
| `log_entries.channel`                 | object   | Polymorphic channel (e.g. api, email, nagios) depending on type.                                    |
| `log_entries.agent`                   | object   | User, service, or integration that created or modified the entry.                                   |
| `log_entries.note`                    | string   | Optional note included with the log entry.                                                          |
| `log_entries.contexts`                | array    | Contexts such as links to graphs or images.                                                         |
| `log_entries.service`                 | object   | Output field: log\_entries.service                                                                  |
| `log_entries.incident`                | object   | Unique identifier                                                                                   |
| `log_entries.teams`                   | array    | Team references unless expanded via include.                                                        |
| `log_entries.event_details`           | object   | Output field: log\_entries.event\_details                                                           |
| `log_entries.changeset`               | array    | String records of custom field updates.                                                             |

### Output Example

`{"offset":123,"limit":123,"more":true,"total":{},"log_entries":[{"acknowledgement_timeout":123,"type":"string","id":"12345678-1234-1234-1234-123456789abc","summary":"string","self":"string","html_url":"string","created_at":"string","channel":{},"agent":{},"note":"string","contexts":[],"service":{},"incident":{},"teams":[],"event_details":{}}]}`

## Get a Log Entry

Get details for a specific incident log entry in PagerDuty, providing additional information for raw event data. Requires OAuth scope incidents.read and the log entry ID.

### Endpoint

- **URL:** `/log_entries/{{id}}`
- **Method:** `GET`

### Input

| **Argument Name**      | **Type** | **Required** | **Description**                                                                            |
| ---------------------- | -------- | ------------ | ------------------------------------------------------------------------------------------ |
| `path_parameters.id`   | string   | Required     | The ID of the log entry resource.                                                          |
| `parameters.include`   | string   | Optional     | Additional models to include. Allowed values are incidents, services, channels, and teams. |
| `parameters.time_zone` | string   | Optional     | Time zone in which results are rendered; defaults to the account time zone.                |
| `headers`              | object   | Required     | HTTP headers for the request                                                               |
| `headers.Accept`       | string   | Required     | Versioning header. Default application/vnd.pagerduty+json;version=2                        |
| `headers.Content-Type` | string   | Required     | Allowed value application/json.                                                            |

### Input Example

`{"parameters":{"include":"incidents","time_zone":"America/Los_Angeles"},"path_parameters":{"id":"Q02JTSNZWHSEKV"},"headers":{"Accept":"application/vnd.pagerduty+json;version=2","Content-Type":"application/json"}}`

### Output

| **Parameter**                       | **Type** | **Description**                                                                                   |
| ----------------------------------- | -------- | ------------------------------------------------------------------------------------------------- |
| `status_code`                       | number   | HTTP status code of the response                                                                  |
| `reason`                            | string   | Response reason phrase                                                                            |
| `log_entry`                         | object   | Polymorphic; schema depends on type (e.g. trigger\_log\_entry).                                   |
| `log_entry.acknowledgement_timeout` | number   | Duration for which the acknowledgement lasts, in seconds; may be absent or null on older entries. |
| `log_entry.type`                    | string   | Entity type name (e.g. trigger\_log\_entry).                                                      |
| `log_entry.id`                      | string   | Unique identifier                                                                                 |
| `log_entry.summary`                 | string   | Short-form server-generated label for the object.                                                 |
| `log_entry.self`                    | string   | API URL for this object.                                                                          |
| `log_entry.html_url`                | string   | URL where the entity is shown in the web app.                                                     |
| `log_entry.created_at`              | string   | When the log entry was created.                                                                   |
| `log_entry.channel`                 | object   | Polymorphic channel (e.g. api, email, nagios) depending on type.                                  |
| `log_entry.agent`                   | object   | User, service, or integration that created or modified the entry.                                 |
| `log_entry.note`                    | string   | Optional note included with the log entry.                                                        |
| `log_entry.contexts`                | array    | Contexts such as links to graphs or images.                                                       |
| `log_entry.service`                 | object   | Output field: log\_entry.service                                                                  |
| `log_entry.incident`                | object   | Unique identifier                                                                                 |
| `log_entry.teams`                   | array    | Team references unless expanded via include.                                                      |
| `log_entry.event_details`           | object   | Output field: log\_entry.event\_details                                                           |
| `log_entry.changeset`               | array    | String records of custom field updates.                                                           |

### Output Example

`{"log_entry":{"acknowledgement_timeout":123,"type":"string","id":"12345678-1234-1234-1234-123456789abc","summary":"string","self":"string","html_url":"string","created_at":"string","channel":{},"agent":{},"note":"string","contexts":[],"service":{},"incident":{},"teams":[],"event_details":{}}}`

## List all of the on Calls

List the on-call entries in PagerDuty during a specified time range. Requires headers for authentication.

### Endpoint

- **URL:** `/oncalls`
- **Method:** `GET`

### Input

| **Argument Name**                    | **Type** | **Required** | **Description**                                    |
| ------------------------------------ | -------- | ------------ | -------------------------------------------------- |
| `parameters.limit`                   | number   | Optional     | Parameters for the List all of the on Calls action |
| `parameters.offset`                  | number   | Optional     | Parameters for the List all of the on Calls action |
| `parameters.total`                   | boolean  | Optional     | Parameters for the List all of the on Calls action |
| `parameters.earliest`                | boolean  | Optional     | Parameters for the List all of the on Calls action |
| `parameters.escalation_policy_ids[]` | array    | Optional     | Parameters for the List all of the on Calls action |
| `parameters.include[]`               | string   | Optional     | Parameters for the List all of the on Calls action |
| `parameters.schedule_ids[]`          | array    | Optional     | Parameters for the List all of the on Calls action |
| `parameters.since`                   | string   | Optional     | Parameters for the List all of the on Calls action |
| `parameters.time_zone`               | string   | Optional     | Parameters for the List all of the on Calls action |
| `parameters.until`                   | string   | Optional     | Parameters for the List all of the on Calls action |
| `parameters.user_ids[]`              | array    | Optional     | Parameters for the List all of the on Calls action |
| `headers`                            | object   | Required     | HTTP headers for the request                       |
| `headers.Accept`                     | string   | Required     | HTTP headers for the request                       |
| `headers.Content-Type`               | string   | Required     | HTTP headers for the request                       |

### Input Example

`{"parameters":{"limit":25,"offset":0,"total":false,"earliest":false,"escalation_policy_ids[]":["PT20YPA"],"include[]":"users","schedule_ids[]":["PI7DH85"],"since":"2015-03-06T15:28:51-05:00","time_zone":"Asia/Hong_Kong","until":"2015-03-06T15:28:51-05:00","user_ids[]":["PI7DH85"]},"headers":{"Accept":"application/vnd.pagerduty+json;version=2","Content-Type":"application/json"}}`

### Output

| **Parameter**                        | **Type** | **Description**                                  |
| ------------------------------------ | -------- | ------------------------------------------------ |
| `status_code`                        | number   | HTTP status code of the response                 |
| `reason`                             | string   | Response reason phrase                           |
| `oncalls`                            | array    | Output field: oncalls                            |
| `oncalls.escalation_policy`          | object   | Output field: oncalls.escalation\_policy         |
| `oncalls.escalation_policy.id`       | string   | Unique identifier                                |
| `oncalls.escalation_policy.type`     | string   | Type of the resource                             |
| `oncalls.escalation_policy.summary`  | string   | Output field: oncalls.escalation\_policy.summary |
| `oncalls.escalation_policy.self`     | string   | Output field: oncalls.escalation\_policy.self    |
| `oncalls.escalation_policy.html_url` | string   | URL endpoint for the request                     |
| `oncalls.escalation_level`           | number   | Output field: oncalls.escalation\_level          |
| `oncalls.schedule`                   | object   | Output field: oncalls.schedule                   |
| `oncalls.user`                       | object   | Output field: oncalls.user                       |
| `oncalls.user.id`                    | string   | Unique identifier                                |
| `oncalls.user.type`                  | string   | Type of the resource                             |
| `oncalls.user.summary`               | string   | Output field: oncalls.user.summary               |
| `oncalls.user.self`                  | string   | Output field: oncalls.user.self                  |
| `oncalls.user.html_url`              | string   | URL endpoint for the request                     |
| `oncalls.start`                      | object   | Output field: oncalls.start                      |
| `oncalls.end`                        | object   | Output field: oncalls.end                        |
| `limit`                              | number   | Output field: limit                              |
| `offset`                             | number   | Output field: offset                             |
| `more`                               | boolean  | Output field: more                               |
| `total`                              | object   | Output field: total                              |

### Output Example

`{"status_code":200,"response_headers":{"Server":"nginx","Date":"Fri, 10 Nov 2023 07:19:22 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","Vary":"Accept-Encoding, Accept","Access-Control-Allow-Origin":"*","x-frame-options":"SAMEORIGIN","x-xss-protection":"1; mode=block, 1; mode=block","x-content-type-options":"nosniff, nosniff","x-download-options":"noopen","x-permitted-cross-domain-policies":"none","referrer-policy":"strict-origin-when-cross-origin...`

## List Services

Retrieve a list of existing services in PagerDuty. This action requires headers for authentication.

### Endpoint

- **URL:** `/services`
- **Method:** `GET`

### Input

| **Argument Name**       | **Type** | **Required** | **Description**                         |
| ----------------------- | -------- | ------------ | --------------------------------------- |
| `parameters.limit`      | number   | Optional     | Parameters for the List Services action |
| `parameters.offset`     | number   | Optional     | Parameters for the List Services action |
| `parameters.total`      | boolean  | Optional     | Parameters for the List Services action |
| `parameters.query`      | string   | Optional     | Parameters for the List Services action |
| `parameters.include[]`  | string   | Optional     | Parameters for the List Services action |
| `parameters.sort_by`    | string   | Optional     | Parameters for the List Services action |
| `parameters.team_ids[]` | array    | Optional     | Parameters for the List Services action |
| `parameters.time_zone`  | string   | Optional     | Parameters for the List Services action |
| `headers`               | object   | Required     | HTTP headers for the request            |
| `headers.Accept`        | string   | Required     | HTTP headers for the request            |
| `headers.Content-Type`  | string   | Required     | HTTP headers for the request            |

### Input Example

`{"parameters":{"limit":25,"offset":0,"total":false,"query":"","include[]":"teams","sort_by":"name","team_ids[]":["PQ9K7I8"],"time_zone":"Asia/Hong_Kong"},"headers":{"Accept":"application/vnd.pagerduty+json;version=2","Content-Type":"application/json"}}`

### Output

| **Parameter**                          | **Type** | **Description**                                |
| -------------------------------------- | -------- | ---------------------------------------------- |
| `status_code`                          | number   | HTTP status code of the response               |
| `reason`                               | string   | Response reason phrase                         |
| `services`                             | array    | Output field: services                         |
| `services.id`                          | string   | Unique identifier                              |
| `services.name`                        | string   | Name of the resource                           |
| `services.description`                 | string   | Output field: services.description             |
| `services.created_at`                  | string   | Output field: services.created\_at             |
| `services.updated_at`                  | string   | Output field: services.updated\_at             |
| `services.status`                      | string   | Status value                                   |
| `services.teams`                       | array    | Output field: services.teams                   |
| `services.teams.id`                    | string   | Unique identifier                              |
| `services.teams.type`                  | string   | Type of the resource                           |
| `services.teams.summary`               | string   | Output field: services.teams.summary           |
| `services.teams.self`                  | string   | Output field: services.teams.self              |
| `services.teams.html_url`              | string   | URL endpoint for the request                   |
| `services.alert_creation`              | string   | Output field: services.alert\_creation         |
| `services.addons`                      | array    | Output field: services.addons                  |
| `services.addons.file_name`            | string   | Name of the resource                           |
| `services.addons.file`                 | string   | Output field: services.addons.file             |
| `services.scheduled_actions`           | array    | Output field: services.scheduled\_actions      |
| `services.scheduled_actions.file_name` | string   | Name of the resource                           |
| `services.scheduled_actions.file`      | string   | Output field: services.scheduled\_actions.file |
| `services.support_hours`               | object   | Output field: services.support\_hours          |
| `services.last_incident_timestamp`     | object   | Unique identifier                              |
| `services.escalation_policy`           | object   | Output field: services.escalation\_policy      |

### Output Example

`{"status_code":200,"response_headers":{"Server":"nginx","Date":"Fri, 10 Nov 2023 07:28:11 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","Vary":"Accept-Encoding, Accept","Access-Control-Allow-Origin":"*","x-frame-options":"SAMEORIGIN","x-xss-protection":"1; mode=block, 1; mode=block","x-content-type-options":"nosniff, nosniff","x-download-options":"noopen","x-permitted-cross-domain-policies":"none","referrer-policy":"strict-origin-when-cross-origin...`

## List Teams

Retrieve a list of teams from your PagerDuty account, with optional filtering by search query. Requires headers for authentication.

### Endpoint

- **URL:** `/teams`
- **Method:** `GET`

### Input

| **Argument Name**      | **Type** | **Required** | **Description**                      |
| ---------------------- | -------- | ------------ | ------------------------------------ |
| `parameters.limit`     | number   | Optional     | Parameters for the List Teams action |
| `parameters.offset`    | number   | Optional     | Parameters for the List Teams action |
| `parameters.query`     | string   | Optional     | Parameters for the List Teams action |
| `parameters.total`     | boolean  | Optional     | Parameters for the List Teams action |
| `headers`              | object   | Required     | HTTP headers for the request         |
| `headers.Accept`       | string   | Required     | HTTP headers for the request         |
| `headers.Content-Type` | string   | Required     | HTTP headers for the request         |

### Input Example

`{"parameters":{"limit":25,"offset":0,"query":"","total":false},"headers":{"Accept":"application/vnd.pagerduty+json;version=2","Content-Type":"application/json"}}`

### Output

| **Parameter**        | **Type** | **Description**                   |
| -------------------- | -------- | --------------------------------- |
| `status_code`        | number   | HTTP status code of the response  |
| `reason`             | string   | Response reason phrase            |
| `teams`              | array    | Output field: teams               |
| `teams.id`           | string   | Unique identifier                 |
| `teams.name`         | string   | Name of the resource              |
| `teams.description`  | object   | Output field: teams.description   |
| `teams.type`         | string   | Type of the resource              |
| `teams.summary`      | string   | Output field: teams.summary       |
| `teams.self`         | string   | Output field: teams.self          |
| `teams.html_url`     | string   | URL endpoint for the request      |
| `teams.default_role` | string   | Output field: teams.default\_role |
| `teams.parent`       | object   | Output field: teams.parent        |
| `limit`              | number   | Output field: limit               |
| `offset`             | number   | Output field: offset              |
| `total`              | object   | Output field: total               |
| `more`               | boolean  | Output field: more                |

### Output Example

`{"status_code":200,"response_headers":{"Server":"nginx","Date":"Fri, 10 Nov 2023 07:14:02 GMT","Content-Type":"application/json","Content-Length":"603","Connection":"keep-alive","Access-Control-Allow-Origin":"*","x-frame-options":"SAMEORIGIN","x-xss-protection":"1; mode=block, 1; mode=block","x-content-type-options":"nosniff, nosniff","x-download-options":"noopen","x-permitted-cross-domain-policies":"none","referrer-policy":"strict-origin-when-cross-origin, strict-origin-when-cross-origin","Acce...`

## Get a User

Get details about an existing user in PagerDuty using the user's ID as a path parameter.

### Endpoint

- **URL:** `/users/{{id}}`
- **Method:** `GET`

### Input

| **Argument Name**      | **Type** | **Required** | **Description**                                                                                                                  |
| ---------------------- | -------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| `path_parameters.id`   | string   | Required     | The ID of the resource.                                                                                                          |
| `parameters.include[]` | string   | Optional     | Array of additional models to include in the response. Allowed values: contact\_methods, notification\_rules, teams, subdomains. |
| `headers`              | object   | Required     | HTTP headers for the request                                                                                                     |
| `headers.Accept`       | string   | Required     | The Accept header is used as a versioning header.                                                                                |
| `headers.Content-Type` | string   | Required     | Allowed value application/json.                                                                                                  |

### Input Example

`{"parameters":{"include[]":"contact_methods"},"path_parameters":{"id":"PXPGF42"},"headers":{"Accept":"application/vnd.pagerduty+json;version=2","Content-Type":"application/json"}}`

### Output

| **Parameter**                  | **Type** | **Description**                                       |
| ------------------------------ | -------- | ----------------------------------------------------- |
| `status_code`                  | number   | HTTP status code of the response                      |
| `reason`                       | string   | Response reason phrase                                |
| `user`                         | object   | Output field: user                                    |
| `user.id`                      | string   | Unique identifier                                     |
| `user.type`                    | string   | The type of object. Allowed value user.               |
| `user.summary`                 | string   | Short-form server-generated label for the object.     |
| `user.self`                    | string   | API URL for this object.                              |
| `user.html_url`                | string   | URL where the entity is shown in the web app.         |
| `user.name`                    | string   | The name of the user.                                 |
| `user.email`                   | string   | The user's email address.                             |
| `user.time_zone`               | string   | The preferred time zone name for the user.            |
| `user.color`                   | string   | The schedule color for the user.                      |
| `user.role`                    | string   | The user's role in the account.                       |
| `user.avatar_url`              | string   | The URL of the user's avatar.                         |
| `user.description`             | string   | The user's bio or description.                        |
| `user.invitation_sent`         | boolean  | Whether a login invitation has been sent to the user. |
| `user.created_via_sso`         | boolean  | Whether the user account was created via SSO.         |
| `user.job_title`               | string   | The user's job title.                                 |
| `user.contact_methods`         | array    | The list of contact methods for the user.             |
| `user.contact_methods.id`      | string   | HTTP method to use                                    |
| `user.contact_methods.type`    | string   | HTTP method to use                                    |
| `user.contact_methods.summary` | string   | HTTP method to use                                    |
| `user.contact_methods.self`    | string   | HTTP method to use                                    |
| `user.notification_rules`      | array    | The list of notification rules for the user.          |
| `user.notification_rules.id`   | string   | Unique identifier                                     |

### Output Example

`{"user":{"id":"12345678-1234-1234-1234-123456789abc","type":"string","summary":"string","self":"string","html_url":"string","name":"Example Name","email":"user@example.com","time_zone":"string","color":"string","role":"string","avatar_url":"string","description":"string","invitation_sent":true,"created_via_sso":true,"job_title":"string"}}`

## List Users

List users of your PagerDuty account, optionally filtered by a search query. Requires headers for authentication.

### Endpoint

- **URL:** `/users`
- **Method:** `GET`

### Input

| **Argument Name**       | **Type** | **Required** | **Description**                      |
| ----------------------- | -------- | ------------ | ------------------------------------ |
| `parameters.limit`      | number   | Optional     | Parameters for the List Users action |
| `parameters.offset`     | number   | Optional     | Parameters for the List Users action |
| `parameters.total`      | boolean  | Optional     | Parameters for the List Users action |
| `parameters.query`      | string   | Optional     | Parameters for the List Users action |
| `parameters.include[]`  | string   | Optional     | Parameters for the List Users action |
| `parameters.team_ids[]` | array    | Optional     | Parameters for the List Users action |
| `headers`               | object   | Required     | HTTP headers for the request         |
| `headers.Accept`        | string   | Required     | HTTP headers for the request         |
| `headers.Content-Type`  | string   | Required     | HTTP headers for the request         |

### Input Example

`{"parameters":{"limit":25,"offset":0,"total":false,"query":"","include[]":"teams","team_ids[]":["PQ9K7I8"]},"headers":{"Accept":"application/vnd.pagerduty+json;version=2","Content-Type":"application/json"}}`

### Output

| **Parameter**                    | **Type** | **Description**                      |
| -------------------------------- | -------- | ------------------------------------ |
| `status_code`                    | number   | HTTP status code of the response     |
| `reason`                         | string   | Response reason phrase               |
| `users`                          | array    | Output field: users                  |
| `users.name`                     | string   | Name of the resource                 |
| `users.email`                    | string   | Output field: users.email            |
| `users.time_zone`                | string   | Output field: users.time\_zone       |
| `users.color`                    | string   | Output field: users.color            |
| `users.avatar_url`               | string   | URL endpoint for the request         |
| `users.billed`                   | boolean  | Output field: users.billed           |
| `users.role`                     | string   | Output field: users.role             |
| `users.description`              | object   | Output field: users.description      |
| `users.invitation_sent`          | boolean  | Output field: users.invitation\_sent |
| `users.job_title`                | object   | Output field: users.job\_title       |
| `users.teams`                    | array    | Output field: users.teams            |
| `users.teams.id`                 | string   | Unique identifier                    |
| `users.teams.type`               | string   | Type of the resource                 |
| `users.teams.summary`            | string   | Output field: users.teams.summary    |
| `users.teams.self`               | string   | Output field: users.teams.self       |
| `users.teams.html_url`           | string   | URL endpoint for the request         |
| `users.contact_methods`          | array    | HTTP method to use                   |
| `users.contact_methods.id`       | string   | HTTP method to use                   |
| `users.contact_methods.type`     | string   | HTTP method to use                   |
| `users.contact_methods.summary`  | string   | HTTP method to use                   |
| `users.contact_methods.self`     | string   | HTTP method to use                   |
| `users.contact_methods.html_url` | object   | URL endpoint for the request         |

### Output Example

`{"status_code":200,"response_headers":{"Server":"nginx","Date":"Fri, 10 Nov 2023 07:30:38 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","Vary":"Accept-Encoding, Accept","Access-Control-Allow-Origin":"*","x-frame-options":"SAMEORIGIN","x-xss-protection":"1; mode=block, 1; mode=block","x-content-type-options":"nosniff, nosniff","x-download-options":"noopen","x-permitted-cross-domain-policies":"none","referrer-policy":"strict-origin-when-cross-origin...`

## List Notes for an Incident

List existing notes for the specified incident in PagerDuty using the incident ID as a path parameter.

### Endpoint

- **URL:** `/incidents/{{id}}/notes`
- **Method:** `GET`

### Input

| **Argument Name**      | **Type** | **Required** | **Description**                                   |
| ---------------------- | -------- | ------------ | ------------------------------------------------- |
| `path_parameters.id`   | string   | Required     | The ID of the resource.                           |
| `headers`              | object   | Required     | HTTP headers for the request                      |
| `headers.Accept`       | string   | Required     | The Accept header is used as a versioning header. |
| `headers.Content-Type` | string   | Required     | Allowed value application/json.                   |

### Input Example

`{"path_parameters":{"id":"PT4KHLK"},"headers":{"Accept":"application/vnd.pagerduty+json;version=2","Content-Type":"application/json"}}`

### Output

| **Parameter**            | **Type** | **Description**                                                              |
| ------------------------ | -------- | ---------------------------------------------------------------------------- |
| `status_code`            | number   | HTTP status code of the response                                             |
| `reason`                 | string   | Response reason phrase                                                       |
| `notes`                  | array    | Output field: notes                                                          |
| `notes.id`               | string   | Unique identifier of the note.                                               |
| `notes.user`             | object   | The author of the note.                                                      |
| `notes.user.id`          | string   | Unique identifier                                                            |
| `notes.user.type`        | string   | The type of the user reference (e.g. user\_reference, bot\_user\_reference). |
| `notes.user.summary`     | string   | Short-form label for the user.                                               |
| `notes.user.self`        | string   | API URL for the user.                                                        |
| `notes.user.html_url`    | string   | URL where the user is shown in the web app.                                  |
| `notes.channel`          | object   | The channel through which the note was submitted.                            |
| `notes.channel.id`       | string   | Unique identifier                                                            |
| `notes.channel.type`     | string   | The type of channel reference.                                               |
| `notes.channel.summary`  | string   | Short-form label for the channel.                                            |
| `notes.channel.self`     | string   | API URL for the channel.                                                     |
| `notes.channel.html_url` | string   | URL where the channel entity is shown in the web app.                        |
| `notes.content`          | string   | The note content.                                                            |
| `notes.created_at`       | string   | The time at which the note was created.                                      |
| `notes.updated_at`       | string   | The time at which the note was last updated.                                 |

### Output Example

`{"notes":[{"id":"12345678-1234-1234-1234-123456789abc","user":{},"channel":{},"content":"string","created_at":"string","updated_at":"string"}]}`

# Response Headers

| **Header**                        | **Description**                                          | **Example**                                                                                                                                   |
| --------------------------------- | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Access-Control-Allow-Headers      | HTTP response header: Access-Control-Allow-Headers       | Authorization, Content-Type, AuthorizationOauth, X-EARLY-ACCESS, From                                                                         |
| Access-Control-Allow-Methods      | HTTP response header: Access-Control-Allow-Methods       | GET, POST, PUT, DELETE, OPTIONS                                                                                                               |
| Access-Control-Allow-Origin       | HTTP response header: Access-Control-Allow-Origin        | \*                                                                                                                                            |
| Access-Control-Expose-Headers     | HTTP response header: Access-Control-Expose-Headers      |                                                                                                                                               |
| Access-Control-Max-Age            | HTTP response header: Access-Control-Max-Age             | 1728000                                                                                                                                       |
| Cache-Control                     | Directives for caching mechanisms                        | max-age=0, private, must-revalidate                                                                                                           |
| Connection                        | HTTP response header: Connection                         | keep-alive                                                                                                                                    |
| Content-Encoding                  | HTTP response header: Content-Encoding                   | gzip                                                                                                                                          |
| Content-Length                    | The length of the response body in bytes                 | 603                                                                                                                                           |
| Content-Type                      | The media type of the resource                           | application/json                                                                                                                              |
| Date                              | The date and time at which the message was originated    | Fri, 10 Nov 2023 07:14:02 GMT                                                                                                                 |
| ETag                              | An identifier for a specific version of a resource       | W/"3acefd6ef0085c19b3ad9be4885e37e0"                                                                                                          |
| Feature-Policy                    | HTTP response header: Feature-Policy                     | accelerometer 'none'; camera 'none'; geolocation 'none'; gyroscope 'none'; magnetometer 'none'; microphone 'none'; payment 'none'; usb 'none' |
| ratelimit-limit                   | HTTP response header: ratelimit-limit                    | 960                                                                                                                                           |
| ratelimit-remaining               | HTTP response header: ratelimit-remaining                | 955                                                                                                                                           |
| ratelimit-reset                   | HTTP response header: ratelimit-reset                    | 58                                                                                                                                            |
| referrer-policy                   | HTTP response header: referrer-policy                    | strict-origin-when-cross-origin, strict-origin-when-cross-origin                                                                              |
| Server                            | Information about the software used by the origin server | nginx                                                                                                                                         |
| Strict-Transport-Security         | HTTP response header: Strict-Transport-Security          | max-age=31536000; includeSubDomains                                                                                                           |
| Transfer-Encoding                 | HTTP response header: Transfer-Encoding                  | chunked                                                                                                                                       |
| vary                              | HTTP response header: vary                               | Accept                                                                                                                                        |
| x-content-type-options            | HTTP response header: x-content-type-options             | nosniff, nosniff                                                                                                                              |
| x-download-options                | HTTP response header: x-download-options                 | noopen                                                                                                                                        |
| x-frame-options                   | HTTP response header: x-frame-options                    | SAMEORIGIN                                                                                                                                    |
| x-permitted-cross-domain-policies | HTTP response header: x-permitted-cross-domain-policies  | none                                                                                                                                          |
| x-request-id                      | A unique identifier for the request                      | ddabf2ac81e3bded5c563178afae54cb                                                                                                              |
| x-xss-protection                  | HTTP response header: x-xss-protection                   | 1; mode=block, 1; mode=block                                                                                                                  |
