Skip to main content
POST
Create
🔑 Requires the incident_updates.create scope.

Authorizations

Authorization
string
header
required

API key from your incident.io dashboard (Settings → API keys)

Body

application/json
idempotency_key
string
required

Unique string used to de-duplicate incident update requests. Retrying with the same key returns the update the first request created, rather than sharing a second one.

Example:

"alert-uuid"

incident_id
string
required

The incident you want to update

Example:

"01G0J1EXE7AXZ2C93K61WBPYEH"

message
string

Message that explains the context behind the update, in markdown

Example:

"We're working on a fix, hoping to ship in the next 30 minutes"

to_incident_status_id
string

Move the incident to this status

Example:

"01G0J1EXE7AXZ2C93K61WBPYEH"

to_severity_id
string

Move the incident to this severity

Example:

"01FH5TZRWMNAFB0DZ23FD1TV96"

Response

201 - application/json

Created response.

incident_update
object
required