Create an Alert Grouping Setting

Create a new Alert Grouping Setting.

The settings part of Alert Grouper service allows us to create Alert Grouping Settings and configs that are required to be used during grouping of the alerts.

This endpoint will be used to create an instance of AlertGroupingSettings for either one service or many services that are in the alert group setting.

Scoped OAuth requires: services.write

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Header Parameters

Accept*string

The Accept header is used as a versioning header.

Default"application/vnd.pagerduty+json;version=2"

Content-Type*"application/json"

Default"application/json"

Value in

"application/json"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

alert_grouping_setting*

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.

Response Body

`application/json`

curl -X POST "https://example.com/alert_grouping_settings" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json" \  -H "Content-Type: application/json" \  -d '{    "alert_grouping_setting": {      "id": "PZC4OM1",      "name": "Example of Alert Grouping Setting",      "description": "This Alert Grouping Setting is an example",      "type": "content_based",      "config": {        "time_window": 900,        "aggregate": "all",        "fields": [          "summary",          "component",          "custom_details.host",          "custom_details.field1.field2"        ]      },      "services": [        {          "id": "P0KJZ0A"        },        {          "id": "PA15YRT"        }      ]    }  }'

{  "alert_grouping_setting": {    "id": "PZC4OM1",    "name": "Example of Alert Grouping Setting",    "description": "This Alert Grouping Setting is an example",    "type": "content_based",    "config": {      "time_window": 900,      "aggregate": "all",      "fields": [        "summary",        "component",        "custom_details.host",        "custom_details.field1.field2"      ]    },    "services": [      {        "id": "P0KJZ0A",        "name": "Payment Service"      },      {        "id": "PA15YRT",        "name": "Checkout Service"      }    ],    "created_at": "2022-12-13T19:55:01.171Z",    "updated_at": "2023-08-24T18:29:35.630Z"  }}

Create an Alert Grouping Setting

Authorization

Header Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`