> ## Documentation Index
> Fetch the complete documentation index at: https://docs.larm.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Create disruption

> Creates a new disruption, optionally publishing to a status page

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.

<ParamField body="title" type="string" required>
  Disruption title (1–255 characters)
</ParamField>

<ParamField body="started_at" type="string" required>
  When the disruption began (ISO 8601 timestamp, e.g. `2026-03-28T12:00:00Z`)
</ParamField>

<ParamField body="type" type="string" default="disruption">
  `disruption` or `maintenance`
</ParamField>

<ParamField body="impact" type="string" default="major">
  `minor`, `major`, or `critical`
</ParamField>

<ParamField body="message" type="string">
  Initial timeline message. If omitted, the disruption is created with a default message.
</ParamField>

<ParamField body="status_page_id" type="string">
  UUID of the status page to publish to. Must be used together with `components`.
</ParamField>

<ParamField body="components" type="object[]">
  Components to mark as affected. Each object has `id` (component UUID) and `status` (`major_outage`, `partial_outage`, `degraded_performance`, `under_maintenance`, or `operational`).
</ParamField>

<ResponseExample>
  ```json 201 theme={null}
  {
    "data": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "API outage",
      "type": "disruption",
      "status": "investigating",
      "impact": "major",
      "auto_created": false,
      "started_at": "2026-03-28T12:00:00Z",
      "resolved_at": null,
      "updates": [
        {
          "id": "660e8400-e29b-41d4-a716-446655440000",
          "status": "investigating",
          "body": "Investigating API errors.",
          "posted_at": "2026-03-28T12:00:00Z",
          "posted_by": "user@example.com"
        }
      ],
      "affected_components": [
        {
          "id": "770e8400-e29b-41d4-a716-446655440000",
          "name": "API",
          "status": "major_outage"
        }
      ],
      "inserted_at": "2026-03-28T12:00:00Z",
      "updated_at": "2026-03-28T12:00:00Z"
    }
  }
  ```
</ResponseExample>