actions

Creates, updates, deletes, gets or lists an actions resource.

Overview

Name	actions
Type	Resource
Id	pagerduty.incident_workflows.actions

Fields

The following fields are returned by SELECT queries:

get_incident_workflow_action

An Incident Workflow Action

Name	Datatype	Description
id	string
name	string	The descriptive name of the Action
created_by_user_id	string	The obfuscated Id of the User who created this Action
domain_name	string	The Verified Domain of the account that created the action
function_name	string	The Function Name describing the specific functionality of the Action
package_name	string	The Package Name corresponding to the broad category of the Action
action_type	string	The type of Action
created_at	string (date-time)	The date-time at which this Action was created
description	string	A description of the Action
html_url	string (url)	a URL at which the entity is uniquely displayed in the Web app
inputs	array	Inputs whose values used during Action execution
metadata	string	JSON-formatted string of metadata pertaining to the Action
outputs	array	Outputs whose values set during Action execution
search_keywords	array	A set of search keywords to apply to this action.
self	string (url)	the API show URL at which the object is accessible
summary	string	A 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.
tags	array	A set of tags to apply to this action.
trigger_type	string	The type of Trigger this Action is, if action_type is trigger
type	string
version	number	The version of the Action

list_incident_workflow_actions

A paginated array of Incident Workflow Actions

Name	Datatype	Description
id	string
name	string	The descriptive name of the Action
created_by_user_id	string	The obfuscated Id of the User who created this Action
domain_name	string	The Verified Domain of the account that created the action
function_name	string	The Function Name describing the specific functionality of the Action
package_name	string	The Package Name corresponding to the broad category of the Action
action_type	string	The type of Action
created_at	string (date-time)	The date-time at which this Action was created
description	string	A description of the Action
html_url	string (url)	a URL at which the entity is uniquely displayed in the Web app
inputs	array	Inputs whose values used during Action execution
metadata	string	JSON-formatted string of metadata pertaining to the Action
outputs	array	Outputs whose values set during Action execution
search_keywords	array	A set of search keywords to apply to this action.
self	string (url)	the API show URL at which the object is accessible
summary	string	A 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.
tags	array	A set of tags to apply to this action.
trigger_type	string	The type of Trigger this Action is, if action_type is trigger
type	string
version	number	The version of the Action

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_incident_workflow_action	select	id	Accept, Content-Type	Get an Incident Workflow Action Scoped OAuth requires: incident_workflows.read
list_incident_workflow_actions	select		Accept, Content-Type, limit, cursor, keyword	List Incident Workflow Actions Scoped OAuth requires: incident_workflows.read
_list_incident_workflow_actions	exec		Accept, Content-Type, limit, cursor, keyword	List Incident Workflow Actions Scoped OAuth requires: incident_workflows.read
_get_incident_workflow_action	exec	id	Accept, Content-Type	Get an Incident Workflow Action Scoped OAuth requires: incident_workflows.read

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
id	string	The ID of the resource.
Accept	string	The Accept header is used as a versioning header.
Content-Type	string
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.
keyword	string	If provided, only show actions tagged with the specified keyword
limit	integer	The minimum of the limit parameter used in the request or the maximum request size of the API.

SELECT examples

get_incident_workflow_action

Get an Incident Workflow Action

Scoped OAuth requires: incident_workflows.read

SELECT
id,
name,
created_by_user_id,
domain_name,
function_name,
package_name,
action_type,
created_at,
description,
html_url,
inputs,
metadata,
outputs,
search_keywords,
self,
summary,
tags,
trigger_type,
type,
version
FROM pagerduty.incident_workflows.actions
WHERE id = '{{ id }}' -- required
AND Accept = '{{ Accept }}'
AND Content-Type = '{{ Content-Type }}'
;

list_incident_workflow_actions

List Incident Workflow Actions

Scoped OAuth requires: incident_workflows.read

SELECT
id,
name,
created_by_user_id,
domain_name,
function_name,
package_name,
action_type,
created_at,
description,
html_url,
inputs,
metadata,
outputs,
search_keywords,
self,
summary,
tags,
trigger_type,
type,
version
FROM pagerduty.incident_workflows.actions
WHERE Accept = '{{ Accept }}'
AND Content-Type = '{{ Content-Type }}'
AND limit = '{{ limit }}'
AND cursor = '{{ cursor }}'
AND keyword = '{{ keyword }}'
;

Lifecycle Methods

_list_incident_workflow_actions

List Incident Workflow Actions

Scoped OAuth requires: incident_workflows.read

EXEC pagerduty.incident_workflows.actions._list_incident_workflow_actions 
@Accept='{{ Accept }}', 
@Content-Type='{{ Content-Type }}', 
@limit='{{ limit }}', 
@cursor='{{ cursor }}', 
@keyword='{{ keyword }}'
;

_get_incident_workflow_action

Get an Incident Workflow Action

Scoped OAuth requires: incident_workflows.read

EXEC pagerduty.incident_workflows.actions._get_incident_workflow_action 
@id='{{ id }}' --required, 
@Accept='{{ Accept }}', 
@Content-Type='{{ Content-Type }}'
;