List recommended rules

List AI-generated recommended rules available for an account's Service Event Orchestrations.

Results can be filtered by service or team. Use cursor-based pagination to retrieve large result sets.

Note: service_id and service_ids[] cannot be used together in the same request.

Scoped OAuth requires: recommendations.read

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Query Parameters

service_id?string

Filter recommended rules for a single service. Cannot be combined with service_ids[].

service_ids[]?array<string>

Filter recommended rules for multiple services. Cannot be combined with service_id.

team_ids[]?array<string>

An array of team IDs. Only results related to these teams will be returned. Account must have the teams ability to use this parameter.

actions[]?array<>

Filter recommended rules by action type.

limit?integer

The number of results per page.

Range1 <= value <= 50

Default25

cursor?string

Optional parameter used to request the "next" set of results from an API. The value provided here is most commonly obtained from the next_cursor field of the previous request. When no value is provided, the request starts at the beginning of the result set.

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/recommendations/event_orchestrations/rules" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json"

{  "recommended_rules": [    {      "recommendation_id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",      "type": "service",      "status": "available",      "description": "Suppress alerts where event.summary matches 'disk usage'",      "pcl_expr": "event.summary matches part 'disk usage'",      "created_at": "2026-01-15T10:30:00Z",      "updated_at": "2026-01-15T10:30:00Z",      "metrics": {        "num_events_matching_rule": 1200,        "num_events_with_action": 950,        "num_events_with_action_matching_rule": 900,        "precision_metric": 0.75,        "recall": 0.95      },      "actions": {        "suppress": true      },      "parent": {        "id": "P1ABC23",        "type": "service_reference"      }    }  ],  "next_cursor": "eyJ2ZXJzaW9uIjoxLCJwYWdlIjoyLCJuZXh0X3JlY29tbWVuZGF0aW9uIjpudWxsfQ=="}

List recommended rules

Authorization

Query Parameters

Header Parameters

Response Body

200application/json

400application/json

401application/json

403application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`