Update an Orchestration

Update a Global Event Orchestration.

Global Event Orchestrations allow you define a set of Global Rules and Router Rules, so that when you ingest events using the Orchestration's Routing Key your events will have actions applied via the Global Rules & then routed to the correct Service by the Router Rules, based on the event's content.

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

TypeScript Definitions

Use the request body type in TypeScript.

orchestration*

Response Body

`application/json`

curl -X PUT "https://example.com/event_orchestrations/{id}" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json" \  -H "Content-Type: application/json" \  -d '{    "orchestration": {      "name": "Go-Kart Orchestration"    }  }'

{  "orchestration": {    "id": "b02e973d-9620-4e0a-9edc-00fedf7d4694",    "self": "https://api.pagerduty.com/event_orchestrations/b02e973d-9620-4e0a-9edc-00fedf7d4694",    "name": "Go-Kart Orchestration",    "description": "Orchestration that does some stuff",    "team": {      "id": "PWL7QXS",      "type": "team_reference",      "self": "https://api.pagerduty.com/teams/PWL7QXS"    },    "integrations": [      {        "id": "9c5ff030-12da-4204-a067-25ee61a8df6c",        "label": "Go-Kart Orchestration Default Integration",        "parameters": {          "routing_key": "R028DIE06SNKNO6V5ACSLRV7Y0TUVG7T",          "type": "global"        }      }    ],    "routes": 0,    "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-19T11:42:32Z",    "updated_by": {      "id": "P8B9WR8",      "self": "https://api.pagerduty.com/users/P8B9WR8",      "type": "user_reference"    },    "version": "BrWLKQBLm8QO2ZYQ0GosHLxdbgWZ0ZR3"  }}

Update an 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`