Create a status update on an incident

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

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Path Parameters

id*string

The ID of the resource.

Header Parameters

Accept*string

The Accept header is used as a versioning header.

Default"application/vnd.pagerduty+json;version=2"

Content-Type*"application/json"

Default"application/json"

Value in

"application/json"

From*string

The email address of a valid user associated with the account making the request.

Formatemail

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

message*string

The message to be posted as a status update.

subject?string

The subject to be sent for the custom html email status update. Required if sending custom html email.

html_message?string

The html content to be sent for the custom html email status update. Required if sending custom html email.

Response Body

`application/json`

curl -X POST "https://example.com/incidents/{id}/status_updates" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json" \  -H "From: user@example.com" \  -H "Content-Type: application/json" \  -d '{    "message": "The server fire is spreading.",    "subject": "Server Fire Update",    "html_message": "<h1>Server is still on fire</h1>"  }'

{  "status_update": {    "id": "PWL7QXS",    "message": "The server fire is spreading.",    "sender": {      "id": "PXPGF42",      "type": "user_reference",      "summary": "Earline Greenholt",      "self": "https://api.pagerduty.com/users/PXPGF42",      "html_url": "https://subdomain.pagerduty.com/users/PXPGF42"    },    "created_at": "2013-03-06T15:28:51-05:00",    "html_message": "<h1>Server is still on fire</h1>",    "subject": "Server Fire Update"  }}

Create a status update on an incident

Authorization

Path Parameters

Header Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`