---
title: "Create incident"
method: POST
path: "/api/status-page/{statusPageId}/incident/new"
tags: ["Status Page Incidents"]
---

# Create incident

`POST /api/status-page/{statusPageId}/incident/new`

## Request

- Base URL: `https://api.spike.sh`
- URL: `https://api.spike.sh/api/status-page/{statusPageId}/incident/new`
- Auth: none declared. Required headers: `x-api-key`
- TypeScript: <https://skmtc.dev/spike/apis/spike-sh-api/docs/api/status-page/:statusPageId/incident/new/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new incident on a status page

## Path parameters

- `statusPageId` string, required

## Headers

- `x-api-key` string, required

## Request body

- object
  - `title` string, required: Incident title
  - `desc` string, required: Incident description
  - `severity` 'operational' | 'degraded-performance' | 'partial-outage' | 'critical-outage', required: Incident severity
  - `componentStatus` object[], required
    - `id` string, required: Component ID
    - `status` 'operational' | 'degraded-performance' | 'partial-outage' | 'critical-outage', required: Component status
  - `notify` boolean: Whether to notify subscribers
  - `identifiedAtTime` string: Time when incident was identified (HH:mm)
  - `identifiedAt` string: Date when incident was identified (DD/MM/YYYY)

## Response `200`

Incident created successfully

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/spike/apis/spike-sh-api.md) - [All operations](https://skmtc.dev/spike/apis/spike-sh-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spike/apis/spike-sh-api/revisions/6854629119aa?raw)