POST /incidents/{id}/status_updates
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.
An incident represents a problem or an issue that needs to be addressed and resolved.
For more information see the API Concepts Document
Scoped OAuth requires: incidents.write
Servers
- https://api.pagerduty.com
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
String | Yes |
The ID of the resource. |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Accept |
String | Yes |
The Default value: "application/vnd.pagerduty+json;version=2" |
Content-Type |
String | Yes |
Possible values:
Default value: "application/json" |
From |
String | Yes |
The email address of a valid user associated with the account making the request. |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
html_message |
String | No |
The html content to be sent for the custom html email status update. Required if sending custom html email. |
message |
String | Yes |
The message to be posted as a status update. |
subject |
String | No |
The subject to be sent for the custom html email status update. Required if sending custom html email. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.