Procedures

Automation procedures in the PagerDuty book.

The following documentation is for PagerDuty v1.0.3 (BDK).

Make sure to add the PagerDuty book to your agent before using these automation procedures.

to create an (incident) in pagerduty

Create an incident in PagerDuty.

Input Concepts

Concept	Description	Type	Required	Default Value
payload	The data for the incident to create.	pagerduty incident creation payload	Yes	(no default)

Output Concepts

Concept	Description	Type
incident	The created incident.	pagerduty incident

Examples

Create an incident in PagerDuty

create a json
use the above as the body
the body's title is "Application Failure"
the body's type is "incident"
get '{"id": "P0ED7MS", "type": "service_reference"}' as a json
use the above as the service
the body's service is the service
create an incident in pagerduty
    the payload is the body

to get some (incidents) from pagerduty

FILTER - CAPABLE

Get incidents from PagerDuty using a Filter Expression.

Output Concepts

Concept	Description	Type
incidents	A list of incidents.	pagerduty incident

Examples

Get all incidents from PagerDuty

get some incidents from pagerduty

to manage an (incident) in pagerduty

Manage an incident in PagerDuty.

Manage (update) an incident in PagerDuty. The 'From' header with a valid user email may be required by PagerDuty for this operation, depending on what was the authentication method used.

Input Concepts

Concept	Description	Type	Required	Default Value
incident	The ID of the incident to update.	pagerduty incident	Yes	(no default)
payload	The data to update for the incident.	pagerduty incident update payload	Yes	(no default)
user email	The email of the PagerDuty user for 'From' header in write operations.	text	No	(no default)

Output Concepts

Concept	Description	Type
incident	The updated incident.	pagerduty incident

Examples

Manage an incident in PagerDuty

get some incidents from pagerduty
get the first incident as the incident
create a json
use the above as the body
the body's status is "acknowledged"
manage the incident in pagerduty
    the payload is the incident
    the user email is "[email protected]"