> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# pagerduty-services

> PagerDuty Services — manage services, escalation policies, event orchestrations, and alert grouping

**Server path:** `/pagerduty-services` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                                                | Description                                             |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| [`pagerduty_services_create_service`](#pagerduty_services_create_service)                                           | Create a service                                        |
| [`pagerduty_services_delete_alert_grouping_setting`](#pagerduty_services_delete_alert_grouping_setting)             | Delete an Alert Grouping Setting                        |
| [`pagerduty_services_get_alert_grouping_setting`](#pagerduty_services_get_alert_grouping_setting)                   | Get an Alert Grouping Setting                           |
| [`pagerduty_services_get_change_event`](#pagerduty_services_get_change_event)                                       | Get a Change Event                                      |
| [`pagerduty_services_get_escalation_policy`](#pagerduty_services_get_escalation_policy)                             | Get an escalation policy                                |
| [`pagerduty_services_get_orch_path_global`](#pagerduty_services_get_orch_path_global)                               | Get the Global Orchestration for an Event Orchestration |
| [`pagerduty_services_get_orch_path_router`](#pagerduty_services_get_orch_path_router)                               | Get the Router for an Event Orchestration               |
| [`pagerduty_services_get_orch_path_service`](#pagerduty_services_get_orch_path_service)                             | Get the Service Orchestration for a Service             |
| [`pagerduty_services_get_orchestration`](#pagerduty_services_get_orchestration)                                     | Get an Orchestration                                    |
| [`pagerduty_services_get_service`](#pagerduty_services_get_service)                                                 | Get a service                                           |
| [`pagerduty_services_list_alert_grouping_settings`](#pagerduty_services_list_alert_grouping_settings)               | List alert grouping settings                            |
| [`pagerduty_services_list_change_events`](#pagerduty_services_list_change_events)                                   | List Change Events                                      |
| [`pagerduty_services_list_escalation_policies`](#pagerduty_services_list_escalation_policies)                       | List escalation policies                                |
| [`pagerduty_services_list_event_orchestrations`](#pagerduty_services_list_event_orchestrations)                     | List Event Orchestrations                               |
| [`pagerduty_services_list_incident_related_change_events`](#pagerduty_services_list_incident_related_change_events) | List related Change Events for an Incident              |
| [`pagerduty_services_list_service_change_events`](#pagerduty_services_list_service_change_events)                   | List Change Events for a service                        |
| [`pagerduty_services_list_services`](#pagerduty_services_list_services)                                             | List services                                           |
| [`pagerduty_services_post_alert_grouping_settings`](#pagerduty_services_post_alert_grouping_settings)               | Create an Alert Grouping Setting                        |
| [`pagerduty_services_put_alert_grouping_setting`](#pagerduty_services_put_alert_grouping_setting)                   | Update an Alert Grouping Setting                        |
| [`pagerduty_services_update_orch_path_router`](#pagerduty_services_update_orch_path_router)                         | Update the Router for an Event Orchestration            |
| [`pagerduty_services_update_service`](#pagerduty_services_update_service)                                           | Update a service                                        |

***

## pagerduty\_services\_create\_service

Create a service

**Parameters:**

| Parameter      | Type   | Required | Default | Description                                         |
| -------------- | ------ | -------- | ------- | --------------------------------------------------- |
| `Accept`       | string | Yes      | —       | The `Accept` header is used as a versioning header. |
| `Content-Type` | string | Yes      | —       | The content-type value                              |
| `service`      | object | Yes      | —       | The service value                                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "service": {
        "description": "The service value"
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type",
      "service"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_delete\_alert\_grouping\_setting

Delete an Alert Grouping Setting

**Parameters:**

| Parameter      | Type   | Required | Default | Description                                         |
| -------------- | ------ | -------- | ------- | --------------------------------------------------- |
| `Accept`       | string | Yes      | —       | The `Accept` header is used as a versioning header. |
| `Content-Type` | string | Yes      | —       | The content-type value                              |
| `id`           | string | Yes      | —       | The ID of the resource.                             |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "id": {
        "type": "string",
        "description": "The ID of the resource."
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type",
      "id"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_get\_alert\_grouping\_setting

Get an Alert Grouping Setting

**Parameters:**

| Parameter      | Type   | Required | Default | Description                                         |
| -------------- | ------ | -------- | ------- | --------------------------------------------------- |
| `Accept`       | string | Yes      | —       | The `Accept` header is used as a versioning header. |
| `Content-Type` | string | Yes      | —       | The content-type value                              |
| `id`           | string | Yes      | —       | The ID of the resource.                             |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "id": {
        "type": "string",
        "description": "The ID of the resource."
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type",
      "id"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_get\_change\_event

Get a Change Event

**Parameters:**

| Parameter      | Type   | Required | Default | Description                                         |
| -------------- | ------ | -------- | ------- | --------------------------------------------------- |
| `Accept`       | string | Yes      | —       | The `Accept` header is used as a versioning header. |
| `Content-Type` | string | Yes      | —       | The content-type value                              |
| `id`           | string | Yes      | —       | The ID of the resource.                             |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "id": {
        "type": "string",
        "description": "The ID of the resource."
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type",
      "id"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_get\_escalation\_policy

Get an escalation policy

**Parameters:**

| Parameter      | Type   | Required | Default | Description                                         |
| -------------- | ------ | -------- | ------- | --------------------------------------------------- |
| `Accept`       | string | Yes      | —       | The `Accept` header is used as a versioning header. |
| `Content-Type` | string | Yes      | —       | The content-type value                              |
| `id`           | string | Yes      | —       | The ID of the resource.                             |
| `include`      | string | No       | —       | Array of additional Models to include in response.  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "id": {
        "type": "string",
        "description": "The ID of the resource."
      },
      "include": {
        "type": "string",
        "description": "Array of additional Models to include in response.",
        "enum": [
          "services",
          "teams",
          "targets"
        ]
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type",
      "id"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_get\_orch\_path\_global

Get the Global Orchestration for an Event Orchestration

**Parameters:**

| Parameter      | Type   | Required | Default | Description                                         |
| -------------- | ------ | -------- | ------- | --------------------------------------------------- |
| `Accept`       | string | Yes      | —       | The `Accept` header is used as a versioning header. |
| `Content-Type` | string | Yes      | —       | The content-type value                              |
| `id`           | string | Yes      | —       | The ID of an Event Orchestration.                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "id": {
        "type": "string",
        "description": "The ID of an Event Orchestration."
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type",
      "id"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_get\_orch\_path\_router

Get the Router for an Event Orchestration

**Parameters:**

| Parameter      | Type   | Required | Default | Description                                         |
| -------------- | ------ | -------- | ------- | --------------------------------------------------- |
| `Accept`       | string | Yes      | —       | The `Accept` header is used as a versioning header. |
| `Content-Type` | string | Yes      | —       | The content-type value                              |
| `id`           | string | Yes      | —       | The ID of an Event Orchestration.                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "id": {
        "type": "string",
        "description": "The ID of an Event Orchestration."
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type",
      "id"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_get\_orch\_path\_service

Get the Service Orchestration for a Service

**Parameters:**

| Parameter      | Type   | Required | Default | Description                                         |
| -------------- | ------ | -------- | ------- | --------------------------------------------------- |
| `Accept`       | string | Yes      | —       | The `Accept` header is used as a versioning header. |
| `Content-Type` | string | Yes      | —       | The content-type value                              |
| `service_id`   | string | Yes      | —       | The service ID                                      |
| `include`      | string | No       | —       | Array of additional Models to include in response.  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "service_id": {
        "type": "string",
        "description": "The service ID"
      },
      "include": {
        "type": "string",
        "description": "Array of additional Models to include in response.",
        "enum": [
          "migrated_metadata"
        ]
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type",
      "service_id"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_get\_orchestration

Get an Orchestration

**Parameters:**

| Parameter      | Type   | Required | Default | Description                                         |
| -------------- | ------ | -------- | ------- | --------------------------------------------------- |
| `Accept`       | string | Yes      | —       | The `Accept` header is used as a versioning header. |
| `Content-Type` | string | Yes      | —       | The content-type value                              |
| `id`           | string | Yes      | —       | The ID of an Event Orchestration.                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "id": {
        "type": "string",
        "description": "The ID of an Event Orchestration."
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type",
      "id"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_get\_service

Get a service

**Parameters:**

| Parameter      | Type   | Required | Default | Description                                         |
| -------------- | ------ | -------- | ------- | --------------------------------------------------- |
| `Accept`       | string | Yes      | —       | The `Accept` header is used as a versioning header. |
| `Content-Type` | string | Yes      | —       | The content-type value                              |
| `id`           | string | Yes      | —       | The ID of the resource.                             |
| `include`      | string | No       | —       | Array of additional details to include.             |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "id": {
        "type": "string",
        "description": "The ID of the resource."
      },
      "include": {
        "type": "string",
        "description": "Array of additional details to include.",
        "enum": [
          "escalation_policies",
          "teams",
          "auto_pause_notifications_parameters",
          "integrations"
        ]
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type",
      "id"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_list\_alert\_grouping\_settings

List alert grouping settings

**Parameters:**

| Parameter      | Type      | Required | Default | Description                                                                                                                                                                                                                                                                                |
| -------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Accept`       | string    | Yes      | —       | The `Accept` header is used as a versioning header.                                                                                                                                                                                                                                        |
| `Content-Type` | string    | Yes      | —       | The content-type value                                                                                                                                                                                                                                                                     |
| `after`        | string    | No       | —       | Cursor to retrieve next page; only present if next page exists.                                                                                                                                                                                                                            |
| `before`       | string    | No       | —       | Cursor to retrieve previous page; only present if not on first page.                                                                                                                                                                                                                       |
| `total`        | boolean   | No       | —       | 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.  See our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information. |
| `limit`        | integer   | No       | —       | The number of results per page.                                                                                                                                                                                                                                                            |
| `service_ids`  | string\[] | No       | —       | An array of service IDs. Only results related to these services will be returned.                                                                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "after": {
        "type": "string",
        "description": "Cursor to retrieve next page; only present if next page exists."
      },
      "before": {
        "type": "string",
        "description": "Cursor to retrieve previous page; only present if not on first page."
      },
      "total": {
        "type": "boolean",
        "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.  See our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information."
      },
      "limit": {
        "type": "integer",
        "description": "The number of results per page."
      },
      "service_ids": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "An array of service IDs. Only results related to these services will be returned."
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_list\_change\_events

List Change Events

**Parameters:**

| Parameter         | Type      | Required | Default | Description                                                                                                                                                                                                                                                                                |
| ----------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `limit`           | integer   | No       | —       | The number of results per page.                                                                                                                                                                                                                                                            |
| `offset`          | integer   | No       | —       | Offset to start pagination search results.                                                                                                                                                                                                                                                 |
| `total`           | boolean   | No       | —       | 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.  See our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information. |
| `Accept`          | string    | Yes      | —       | The `Accept` header is used as a versioning header.                                                                                                                                                                                                                                        |
| `Content-Type`    | string    | Yes      | —       | The content-type value                                                                                                                                                                                                                                                                     |
| `team_ids`        | string\[] | No       | —       | An array of team IDs. Only results related to these teams will be returned. Account must have the `teams` ability to use this parameter.                                                                                                                                                   |
| `integration_ids` | string\[] | No       | —       | An array of integration IDs. Only results related to these integrations will be returned.                                                                                                                                                                                                  |
| `since`           | string    | No       | —       | The start of the date range over which you want to search, as a UTC ISO 8601 datetime string. Will return an HTTP 400 for non-UTC datetimes.                                                                                                                                               |
| `until`           | string    | No       | —       | The end of the date range over which you want to search, as a UTC ISO 8601 datetime string. Will return an HTTP 400 for non-UTC datetimes.                                                                                                                                                 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "limit": {
        "type": "integer",
        "description": "The number of results per page."
      },
      "offset": {
        "type": "integer",
        "description": "Offset to start pagination search results."
      },
      "total": {
        "type": "boolean",
        "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.  See our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information."
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "team_ids": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "An array of team IDs. Only results related to these teams will be returned. Account must have the `teams` ability to use this parameter."
      },
      "integration_ids": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "An array of integration IDs. Only results related to these integrations will be returned."
      },
      "since": {
        "type": "string",
        "description": "The start of the date range over which you want to search, as a UTC ISO 8601 datetime string. Will return an HTTP 400 for non-UTC datetimes."
      },
      "until": {
        "type": "string",
        "description": "The end of the date range over which you want to search, as a UTC ISO 8601 datetime string. Will return an HTTP 400 for non-UTC datetimes."
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_list\_escalation\_policies

List escalation policies

**Parameters:**

| Parameter      | Type      | Required | Default | Description                                                                                                                                                                                                                                                                                |
| -------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `limit`        | integer   | No       | —       | The number of results per page.                                                                                                                                                                                                                                                            |
| `offset`       | integer   | No       | —       | Offset to start pagination search results.                                                                                                                                                                                                                                                 |
| `total`        | boolean   | No       | —       | 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.  See our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information. |
| `Accept`       | string    | Yes      | —       | The `Accept` header is used as a versioning header.                                                                                                                                                                                                                                        |
| `Content-Type` | string    | Yes      | —       | The content-type value                                                                                                                                                                                                                                                                     |
| `query`        | string    | No       | —       | Filters the result, showing only the records whose name matches the query.                                                                                                                                                                                                                 |
| `user_ids`     | string\[] | No       | —       | Filters the results, showing only escalation policies on which any of the users is a target.                                                                                                                                                                                               |
| `team_ids`     | string\[] | No       | —       | An array of team IDs. Only results related to these teams will be returned. Account must have the `teams` ability to use this parameter.                                                                                                                                                   |
| `include`      | string    | No       | —       | Array of additional Models to include in response.                                                                                                                                                                                                                                         |
| `sort_by`      | string    | No       | —       | Used to specify the field you wish to sort the results on.                                                                                                                                                                                                                                 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "limit": {
        "type": "integer",
        "description": "The number of results per page."
      },
      "offset": {
        "type": "integer",
        "description": "Offset to start pagination search results."
      },
      "total": {
        "type": "boolean",
        "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.  See our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information."
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "query": {
        "type": "string",
        "description": "Filters the result, showing only the records whose name matches the query."
      },
      "user_ids": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Filters the results, showing only escalation policies on which any of the users is a target."
      },
      "team_ids": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "An array of team IDs. Only results related to these teams will be returned. Account must have the `teams` ability to use this parameter."
      },
      "include": {
        "type": "string",
        "description": "Array of additional Models to include in response.",
        "enum": [
          "services",
          "teams",
          "targets"
        ]
      },
      "sort_by": {
        "type": "string",
        "description": "Used to specify the field you wish to sort the results on.",
        "enum": [
          "name",
          "name:asc",
          "name:desc"
        ]
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_list\_event\_orchestrations

List Event Orchestrations

**Parameters:**

| Parameter      | Type    | Required | Default | Description                                                |
| -------------- | ------- | -------- | ------- | ---------------------------------------------------------- |
| `Accept`       | string  | Yes      | —       | The `Accept` header is used as a versioning header.        |
| `Content-Type` | string  | Yes      | —       | The content-type value                                     |
| `limit`        | integer | No       | —       | The number of results per page.                            |
| `offset`       | integer | No       | —       | Offset to start pagination search results.                 |
| `sort_by`      | string  | No       | —       | Used to specify the field you wish to sort the results on. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "limit": {
        "type": "integer",
        "description": "The number of results per page."
      },
      "offset": {
        "type": "integer",
        "description": "Offset to start pagination search results."
      },
      "sort_by": {
        "type": "string",
        "description": "Used to specify the field you wish to sort the results on.",
        "enum": [
          "name:asc",
          "name:desc",
          "routes:asc",
          "routes:desc",
          "created_at:asc",
          "created_at:desc"
        ]
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_list\_incident\_related\_change\_events

List related Change Events for an Incident

**Parameters:**

| Parameter      | Type    | Required | Default | Description                                         |
| -------------- | ------- | -------- | ------- | --------------------------------------------------- |
| `id`           | string  | Yes      | —       | The ID of the resource.                             |
| `limit`        | integer | No       | —       | The number of results per page.                     |
| `Accept`       | string  | Yes      | —       | The `Accept` header is used as a versioning header. |
| `Content-Type` | string  | Yes      | —       | The content-type value                              |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "The ID of the resource."
      },
      "limit": {
        "type": "integer",
        "description": "The number of results per page."
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      }
    },
    "required": [
      "PCID",
      "id",
      "Accept",
      "Content-Type"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_list\_service\_change\_events

List Change Events for a service

**Parameters:**

| Parameter         | Type      | Required | Default | Description                                                                                                                                                                                                                                                                                |
| ----------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`              | string    | Yes      | —       | The ID of the resource.                                                                                                                                                                                                                                                                    |
| `since`           | string    | No       | —       | The start of the date range over which you want to search, as a UTC ISO 8601 datetime string. Will return an HTTP 400 for non-UTC datetimes.                                                                                                                                               |
| `until`           | string    | No       | —       | The end of the date range over which you want to search, as a UTC ISO 8601 datetime string. Will return an HTTP 400 for non-UTC datetimes.                                                                                                                                                 |
| `limit`           | integer   | No       | —       | The number of results per page.                                                                                                                                                                                                                                                            |
| `offset`          | integer   | No       | —       | Offset to start pagination search results.                                                                                                                                                                                                                                                 |
| `total`           | boolean   | No       | —       | 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.  See our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information. |
| `Accept`          | string    | Yes      | —       | The `Accept` header is used as a versioning header.                                                                                                                                                                                                                                        |
| `Content-Type`    | string    | Yes      | —       | The content-type value                                                                                                                                                                                                                                                                     |
| `team_ids`        | string\[] | No       | —       | An array of team IDs. Only results related to these teams will be returned. Account must have the `teams` ability to use this parameter.                                                                                                                                                   |
| `integration_ids` | string\[] | No       | —       | An array of integration IDs. Only results related to these integrations will be returned.                                                                                                                                                                                                  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "The ID of the resource."
      },
      "since": {
        "type": "string",
        "description": "The start of the date range over which you want to search, as a UTC ISO 8601 datetime string. Will return an HTTP 400 for non-UTC datetimes."
      },
      "until": {
        "type": "string",
        "description": "The end of the date range over which you want to search, as a UTC ISO 8601 datetime string. Will return an HTTP 400 for non-UTC datetimes."
      },
      "limit": {
        "type": "integer",
        "description": "The number of results per page."
      },
      "offset": {
        "type": "integer",
        "description": "Offset to start pagination search results."
      },
      "total": {
        "type": "boolean",
        "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.  See our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information."
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "team_ids": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "An array of team IDs. Only results related to these teams will be returned. Account must have the `teams` ability to use this parameter."
      },
      "integration_ids": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "An array of integration IDs. Only results related to these integrations will be returned."
      }
    },
    "required": [
      "PCID",
      "id",
      "Accept",
      "Content-Type"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_list\_services

List services

**Parameters:**

| Parameter      | Type      | Required | Default | Description                                                                                                                                                                                                                                                                                |
| -------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Accept`       | string    | Yes      | —       | The `Accept` header is used as a versioning header.                                                                                                                                                                                                                                        |
| `Content-Type` | string    | Yes      | —       | The content-type value                                                                                                                                                                                                                                                                     |
| `query`        | string    | No       | —       | Filters the result, showing only the records whose name matches the query.                                                                                                                                                                                                                 |
| `limit`        | integer   | No       | —       | The number of results per page.                                                                                                                                                                                                                                                            |
| `offset`       | integer   | No       | —       | Offset to start pagination search results.                                                                                                                                                                                                                                                 |
| `total`        | boolean   | No       | —       | 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.  See our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information. |
| `team_ids`     | string\[] | No       | —       | An array of team IDs. Only results related to these teams will be returned. Account must have the `teams` ability to use this parameter.                                                                                                                                                   |
| `time_zone`    | string    | No       | —       | Time zone in which results will be rendered. This will default to the account time zone.                                                                                                                                                                                                   |
| `sort_by`      | string    | No       | —       | Used to specify the field you wish to sort the results on.                                                                                                                                                                                                                                 |
| `include`      | string    | No       | —       | Array of additional details to include.                                                                                                                                                                                                                                                    |
| `name`         | string    | No       | —       | Filters the results, showing only services with the specified name.                                                                                                                                                                                                                        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "query": {
        "type": "string",
        "description": "Filters the result, showing only the records whose name matches the query."
      },
      "limit": {
        "type": "integer",
        "description": "The number of results per page."
      },
      "offset": {
        "type": "integer",
        "description": "Offset to start pagination search results."
      },
      "total": {
        "type": "boolean",
        "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.  See our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information."
      },
      "team_ids": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "An array of team IDs. Only results related to these teams will be returned. Account must have the `teams` ability to use this parameter."
      },
      "time_zone": {
        "type": "string",
        "description": "Time zone in which results will be rendered. This will default to the account time zone."
      },
      "sort_by": {
        "type": "string",
        "description": "Used to specify the field you wish to sort the results on.",
        "enum": [
          "name",
          "name:asc",
          "name:desc"
        ]
      },
      "include": {
        "type": "string",
        "description": "Array of additional details to include.",
        "enum": [
          "escalation_policies",
          "teams",
          "integrations",
          "auto_pause_notifications_parameters"
        ]
      },
      "name": {
        "type": "string",
        "description": "Filters the results, showing only services with the specified name."
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_post\_alert\_grouping\_settings

Create an Alert Grouping Setting

**Parameters:**

| Parameter                | Type   | Required | Default | Description                                                                                                                                                                             |
| ------------------------ | ------ | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Accept`                 | string | Yes      | —       | The `Accept` header is used as a versioning header.                                                                                                                                     |
| `Content-Type`           | string | Yes      | —       | The content-type value                                                                                                                                                                  |
| `alert_grouping_setting` | object | Yes      | —       | Defines how alerts will be automatically grouped into incidents based on the configurations defined. Note that the Alert Grouping Setting features are available only on certain plans. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "alert_grouping_setting": {
        "type": "object",
        "description": "Defines how alerts will be automatically grouped into incidents based on the configurations defined. Note that the Alert Grouping Setting features are available only on certain plans.",
        "properties": {
          "id": {
            "type": "string",
            "description": "The id value"
          },
          "name": {
            "type": "string",
            "description": "An optional short-form string that provides succinct information about an AlertGroupingSetting object suitable for primary labeling of the entity. It is not intended to be an identifier."
          },
          "description": {
            "type": "string",
            "description": "An optional description in string that provides more information about an AlertGroupingSetting object."
          },
          "type": {
            "type": "string",
            "description": "The type value",
            "enum": [
              "content_based",
              "content_based_intelligent",
              "intelligent",
              "time"
            ]
          },
          "config": {
            "description": "The config value"
          },
          "services": {
            "type": "array",
            "description": "The array of one or many Services with just ServiceID/name that the AlertGroupingSetting applies to. Type of content_based_intelligent allows for only one service in the array."
          },
          "created_at": {
            "type": "string",
            "description": "The ISO8601 date/time an AlertGroupingSetting got created at."
          },
          "updated_at": {
            "type": "string",
            "description": "The ISO8601 date/time an AlertGroupingSetting last got updated at."
          }
        }
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type",
      "alert_grouping_setting"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_put\_alert\_grouping\_setting

Update an Alert Grouping Setting

**Parameters:**

| Parameter                | Type   | Required | Default | Description                                                                                                                                                                             |
| ------------------------ | ------ | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Accept`                 | string | Yes      | —       | The `Accept` header is used as a versioning header.                                                                                                                                     |
| `Content-Type`           | string | Yes      | —       | The content-type value                                                                                                                                                                  |
| `id`                     | string | Yes      | —       | The ID of the resource.                                                                                                                                                                 |
| `alert_grouping_setting` | object | Yes      | —       | Defines how alerts will be automatically grouped into incidents based on the configurations defined. Note that the Alert Grouping Setting features are available only on certain plans. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "id": {
        "type": "string",
        "description": "The ID of the resource."
      },
      "alert_grouping_setting": {
        "type": "object",
        "description": "Defines how alerts will be automatically grouped into incidents based on the configurations defined. Note that the Alert Grouping Setting features are available only on certain plans.",
        "properties": {
          "id": {
            "type": "string",
            "description": "The id value"
          },
          "name": {
            "type": "string",
            "description": "An optional short-form string that provides succinct information about an AlertGroupingSetting object suitable for primary labeling of the entity. It is not intended to be an identifier."
          },
          "description": {
            "type": "string",
            "description": "An optional description in string that provides more information about an AlertGroupingSetting object."
          },
          "type": {
            "type": "string",
            "description": "The type value",
            "enum": [
              "content_based",
              "content_based_intelligent",
              "intelligent",
              "time"
            ]
          },
          "config": {
            "description": "The config value"
          },
          "services": {
            "type": "array",
            "description": "The array of one or many Services with just ServiceID/name that the AlertGroupingSetting applies to. Type of content_based_intelligent allows for only one service in the array."
          },
          "created_at": {
            "type": "string",
            "description": "The ISO8601 date/time an AlertGroupingSetting got created at."
          },
          "updated_at": {
            "type": "string",
            "description": "The ISO8601 date/time an AlertGroupingSetting last got updated at."
          }
        }
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type",
      "id",
      "alert_grouping_setting"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_update\_orch\_path\_router

Update the Router for an Event Orchestration

**Parameters:**

| Parameter            | Type   | Required | Default | Description                                         |
| -------------------- | ------ | -------- | ------- | --------------------------------------------------- |
| `Accept`             | string | Yes      | —       | The `Accept` header is used as a versioning header. |
| `Content-Type`       | string | Yes      | —       | The content-type value                              |
| `id`                 | string | Yes      | —       | The ID of an Event Orchestration.                   |
| `orchestration_path` | object | Yes      | —       | Orchestration Path                                  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "id": {
        "type": "string",
        "description": "The ID of an Event Orchestration."
      },
      "orchestration_path": {
        "description": "Orchestration Path"
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type",
      "id",
      "orchestration_path"
    ]
  }
  ```
</Expandable>

***

## pagerduty\_services\_update\_service

Update a service

**Parameters:**

| Parameter      | Type   | Required | Default | Description                                         |
| -------------- | ------ | -------- | ------- | --------------------------------------------------- |
| `Accept`       | string | Yes      | —       | The `Accept` header is used as a versioning header. |
| `Content-Type` | string | Yes      | —       | The content-type value                              |
| `id`           | string | Yes      | —       | The ID of the resource.                             |
| `service`      | object | Yes      | —       | The service value                                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "Accept": {
        "type": "string",
        "description": "The `Accept` header is used as a versioning header."
      },
      "Content-Type": {
        "type": "string",
        "description": "The content-type value",
        "enum": [
          "application/json"
        ]
      },
      "id": {
        "type": "string",
        "description": "The ID of the resource."
      },
      "service": {
        "description": "The service value"
      }
    },
    "required": [
      "PCID",
      "Accept",
      "Content-Type",
      "id",
      "service"
    ]
  }
  ```
</Expandable>