List alert grouping settings

List all of your alert grouping settings including both single service settings and global content based settings.

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.

Scoped OAuth requires: services.read

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Query Parameters

after?string

Cursor to retrieve next page; only present if next page exists.

before?string

Cursor to retrieve previous page; only present if not on first page.

total?boolean

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 for more information.

Defaultfalse

limit?integer

The number of results per page.

service_ids[]?array<string>

An array of service IDs. Only results related to these services will be returned.

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"

Response Body

`application/json`

curl -X GET "https://example.com/alert_grouping_settings" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json"

{  "alert_grouping_settings": [    {      "id": "PJWA06X",      "name": "Example of Alert Grouping Setting",      "description": "This is an example of list of Alert Grouping Settings",      "type": "content_based",      "config": {        "time_window": 86400,        "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"    }  ],  "after": "g3QAAAACZAACaWRhB2QAC2luc2VydGVkX2F0dAAAAAlkAApfX3N0cnVjdF9fZAAURWxpeGlyLk5haXZlRGF0ZVRpbWVkAAhjYWxlbmRhcmQAE0VsaXhpci5DYWxlbmRhci5JU09kAANkYXlhA2QABGhvdXJhFGQAC21pY3Jvc2Vjb25kaAJiAAL81WEGZAAGbWludXRlYR5kAAVtb250aGEIZAAGc2Vjb25kYR5kAAR5ZWFyYgAAB",  "before": "g3QAAAACZAACaWRhCGQAC2luc2VydGVkX2F0dAAAAAlkAApfX3N0cnVjdF9fZAAURWxpeGlyLk5haXZlRGF0ZVRpbWVkAAhjYWxlbmRhcmQAE0VsaXhpci5DYWxlbmRhci5JU09kAANkYXlhA2QABGhvdXJhFGQAC21pY3Jvc2Vjb25kaAJiAANYzWEGZAAGbWludXRlYR5kAAVtb250aGEIZAAGc2Vjb25kYR5kAAR5ZWFyYgAAB",  "limit": 25,  "total": null}

List alert grouping settings

Authorization

Query Parameters

Header Parameters

Response Body

200application/json

401application/json

`application/json`

`application/json`