statuses

Creates, updates, deletes, gets or lists a statuses resource.

Overview

Name	statuses
Type	Resource
Id	pagerduty.status_pages.statuses

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
id	string	An unique identifier within Status Page scope that defines a Status entry.
description	string	The description is a human-readable text that describes the Status level.
post_type	string	The type of the Post. (incident, maintenance)
self	string	The API resource URL of the Status.
status_page	object	Status Page
type	string	The type of the object returned by the API - in this case, a Status Page Status.

list

Name	Datatype	Description
id	string	An unique identifier within Status Page scope that defines a Status entry.
description	string	The description is a human-readable text that describes the Status level.
post_type	string	The type of the Post. (incident, maintenance)
self	string	The API resource URL of the Status.
status_page	object	Status Page
type	string	The type of the object returned by the API - in this case, a Status Page Status.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	id, status_id		Get a Status for a Status Page by Status Page ID and Status ID.<br /><br />Scoped OAuth requires: status_pages.read<br />
list	select	id	post_type	List Statuses for a Status Page by Status Page ID.<br /><br />Scoped OAuth requires: status_pages.read<br />

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.
status_id	string	The ID of the Status Page status.
post_type	string	Filter by Post type.

SELECT examples

get

Get a Status for a Status Page by Status Page ID and Status ID.<br /><br />Scoped OAuth requires: status_pages.read<br />

SELECT
id,
description,
post_type,
self,
status_page,
type
FROM pagerduty.status_pages.statuses
WHERE id = '{{ id }}' -- required
AND status_id = '{{ status_id }}' -- required
;

list

List Statuses for a Status Page by Status Page ID.<br /><br />Scoped OAuth requires: status_pages.read<br />

SELECT
id,
description,
post_type,
self,
status_page,
type
FROM pagerduty.status_pages.statuses
WHERE id = '{{ id }}' -- required
AND post_type = '{{ post_type }}'
;