Skip to main content
POST
Create disruption
Requires incidents:read_write permission. Create a disruption to communicate a service issue. Optionally publish to a status page with affected components in the same call.
string
required
Disruption title (1–255 characters)
string
required
When the disruption began (ISO 8601 timestamp, e.g. 2026-03-28T12:00:00Z)
string
default:"disruption"
disruption or maintenance
string
default:"major"
minor, major, or critical
string
Initial timeline message. If omitted, the disruption is created with a default message.
string
UUID of the status page to publish to. Must be used together with components.
object[]
Components to mark as affected. Each object has id (component UUID) and status (major_outage, partial_outage, degraded_performance, under_maintenance, or operational).