status_updates

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

Overview

Name	status_updates
Type	Resource
Id	pagerduty.incidents.status_updates

Fields

The following fields are returned by SELECT queries:

SELECT not supported for this resource, use SHOW METHODS to view available operations for the resource.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
create	insert	id, message	From	Create a new status update for the specified incident. Optionally pass subject and html_message properties in the request body to override the email notification that gets sent.<br /><br />An incident represents a problem or an issue that needs to be addressed and resolved.<br /><br />For more information see the [API Concepts Document](https:​//developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#incidents)<br /><br />Scoped OAuth requires: incidents.write<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.
From	string (email)	The email address of a valid user associated with the account making the request.

INSERT examples

create

Create a new status update for the specified incident. Optionally pass subject and html_message properties in the request body to override the email notification that gets sent.<br /><br />An incident represents a problem or an issue that needs to be addressed and resolved.<br /><br />For more information see the [API Concepts Document](https:​//developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#incidents)<br /><br />Scoped OAuth requires: incidents.write<br />

INSERT INTO pagerduty.incidents.status_updates (
message,
subject,
html_message,
id,
"From"
)
SELECT 
'{{ message }}' /* required */,
'{{ subject }}',
'{{ html_message }}',
'{{ id }}',
'{{ From }}'
RETURNING
status_update
;

Manifest

# Description fields are for documentation purposes
- name: status_updates
props:
  - name: id
    value: "{{ id }}"
    description: Required parameter for the status_updates resource.
  - name: message
    value: "{{ message }}"
    description: |
      The message to be posted as a status update.
  - name: subject
    value: "{{ subject }}"
    description: |
      The subject to be sent for the custom html email status update. Required if sending custom html email.
  - name: html_message
    value: "{{ html_message }}"
    description: |
      The html content to be sent for the custom html email status update. Required if sending custom html email.
  - name: From
    value: "{{ From }}"
    description: The email address of a valid user associated with the account making the request.
    description: The email address of a valid user associated with the account making the request.