Update the Unrouted Orchestration for an Event Orchestration

Update a Global Event Orchestration's Rules for Unrouted events.

An Unrouted Orchestration allows you to create a set of Event Rules that will be evaluated against all events that don't match any rules in the Global Orchestration's Router. Events that reach the Unrouted Orchestration will never be routed to a specific Service.

The Unrouted Orchestration evaluates Events sent to it against each of its rules, beginning with the rules in the "start" set. When a matching rule is found, it can modify and enhance the event and can route the event to another set of rules within this Unrouted Orchestration for further processing.

For more information see the API Concepts Document

Scoped OAuth requires: event_orchestrations.write

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Path Parameters

id*string

The ID of an Event Orchestration.

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

Updates to Unrouted Orchestration rules. Omitted rules and rule details are deleted.

TypeScript Definitions

Use the request body type in TypeScript.

orchestration_path*

Response Body

`application/json`

curl -X PUT "https://example.com/event_orchestrations/{id}/unrouted" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json" \  -H "Content-Type: application/json" \  -d '{    "orchestration_path": {      "sets": [        {          "id": "start",          "rules": [            {              "label": "Update the summary of un-matched Critical alerts so they\'re easier to spot",              "id": "38880ffb",              "conditions": [                {                  "expression": "event.severity matches \'critical\'"                }              ],              "actions": {                "extractions": [                  {                    "target": "event.summary",                    "template": "[Critical Unrouted] {{event.summary}}"                  }                ]              }            },            {              "label": "Reduce the severity of all other unrouted events",              "id": "3896801e",              "conditions": [],              "actions": {                "severity": "info"              }            }          ]        }      ],      "catch_all": {        "actions": {          "suppress": true        }      }    }  }'

{  "orchestration_path": {    "type": "unrouted",    "parent": {      "id": "b02e973d-9620-4e0a-9edc-00fedf7d4694",      "self": "https://api.pagerduty.com/event_orchestrations/b02e973d-9620-4e0a-9edc-00fedf7d4694",      "type": "event_orchestration_reference"    },    "self": "https://api.pagerduty.com/event_orchestrations/b02e973d-9620-4e0a-9edc-00fedf7d4694/router",    "sets": [      {        "id": "start",        "rules": [          {            "label": "Update the summary of un-matched Critical alerts so they're easier to spot",            "id": "38880ffb",            "conditions": [              {                "expression": "event.severity matches 'critical'"              }            ],            "actions": {              "extractions": [                {                  "target": "event.summary",                  "template": "[Critical Unrouted] {{event.summary}}"                }              ]            }          },          {            "label": "Reduce the severity of all other unrouted events",            "id": "3896801e",            "conditions": [],            "actions": {              "severity": "info"            }          }        ]      }    ],    "catch_all": {      "actions": {        "suppress": true      }    },    "created_at": "2021-11-18T16:42:01Z",    "created_by": {      "id": "P8B9WR8",      "self": "https://api.pagerduty.com/users/P8B9WR8",      "type": "user_reference"    },    "updated_at": "2021-11-18T16:42:01Z",    "updated_by": {      "id": "P8B9WR8",      "self": "https://api.pagerduty.com/users/P8B9WR8",      "type": "user_reference"    },    "version": "aZO.EEf9zWb9Vg0NYq.Uqad1hOC2Maod"  },  "warnings": [    {      "feature": "extractions",      "feature_type": "actions",      "message": "This rule uses Dynamic Field Enrichment & Extraction, which is an action not available on your account plan. The rule will be updated, but the action will not be fired when the rule is evaluated",      "rule_id": "3896801e",      "warning_type": "forbidden_feature"    }  ]}

Update the Unrouted Orchestration for an Event Orchestration

Authorization

Path Parameters

Header Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

405application/json

409application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`