Skip to main content
POST
Create
🔑 Requires the incident_lifecycles.update scope.

Authorizations

Authorization
string
header
required

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

Body

application/json
category
enum<string>
required

Whether the status should be considered 'live' (now renamed to active), 'learning' (now renamed to post-incident) or 'closed'. The triage and declined statuses cannot be created or modified.

Available options:
live,
learning,
closed
Example:

"live"

description
string
required

Rich text description of the incident status

Example:

"Impact has been **fully mitigated**, and we're ready to learn from this incident."

name
string
required

Unique name of this status

Example:

"Closed"

Response

201 - application/json

Created response.

incident_status
object
required