Skip to main content

incident_workflows

Overview

Nameincident_workflows
TypeResource
Idpagerduty.incident_workflows.incident_workflows

Fields

NameDatatypeDescription
idstring
namestringA descriptive name for the Incident Workflow
descriptionstringA description of what the Incident Workflow does
_typestring
created_atstringThe timestamp this Incident Workflow was created
html_urlstringa URL at which the entity is uniquely displayed in the Web app
selfstringthe API show URL at which the object is accessible
stepsarrayThe ordered list of steps that execute sequentially as part of the workflow
summarystringA short-form, server-generated string that provides succinct, important information about an object suitable for primary labeling of an entity in a client. In many cases, this will be identical to name, though it is not intended to be an identifier.
teamobjectIf specified then workflow edit permissions will be scoped to members of this team
typestringA string that determines the schema of the object. This must be the standard name for the entity, suffixed by _reference if the object is a reference.

Methods

NameAccessible byRequired ParamsDescription
get_incident_workflowSELECTidGet an existing Incident Workflow
An Incident Workflow is a sequence of configurable Steps and associated Triggers that can execute automated Actions for a given Incident.

Scoped OAuth requires: incident_workflows.read
list_incident_workflowsSELECTList existing Incident Workflows.

This is the best method to use to list all Incident Workflows in your account. If your use case requires listing Incident Workflows associated with a particular Service, you can use the "listIncidentWorkflowsByService" endpoint.

An Incident Workflow is a sequence of configurable Steps and associated Triggers that can execute automated Actions for a given Incident.

Scoped OAuth requires: incident_workflows.read
create_incident_workflow_instanceINSERTid, data__incident_workflow_instanceStart an Instance of an Incident Workflow

An Incident Workflow is a sequence of configurable Steps and associated Triggers that can execute automated Actions for a given Incident.

Scoped OAuth requires: incident_workflows:instances.write
delete_incident_workflowDELETEidDelete an existing Incident Workflow

An Incident Workflow is a sequence of configurable Steps and associated Triggers that can execute automated Actions for a given Incident.

Scoped OAuth requires: incident_workflows.write
_get_incident_workflowEXECidGet an existing Incident Workflow
An Incident Workflow is a sequence of configurable Steps and associated Triggers that can execute automated Actions for a given Incident.

Scoped OAuth requires: incident_workflows.read
_list_incident_workflowsEXECList existing Incident Workflows.

This is the best method to use to list all Incident Workflows in your account. If your use case requires listing Incident Workflows associated with a particular Service, you can use the "listIncidentWorkflowsByService" endpoint.

An Incident Workflow is a sequence of configurable Steps and associated Triggers that can execute automated Actions for a given Incident.

Scoped OAuth requires: incident_workflows.read
post_incident_workflowEXECdata__incident_workflowCreate a new Incident Workflow

An Incident Workflow is a sequence of configurable Steps and associated Triggers that can execute automated Actions for a given Incident.

Scoped OAuth requires: incident_workflows.write
put_incident_workflowEXECid, data__incident_workflowUpdate an Incident Workflow

An Incident Workflow is a sequence of configurable Steps and associated Triggers that can execute automated Actions for a given Incident.

Scoped OAuth requires: incident_workflows.write