Skip to main content
POST
/
api
/
v1
/
incidents
Create incident
curl --request POST \
  --url https://app.larm.dev/api/v1/incidents \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "type": "<string>",
  "impact": "<string>",
  "message": "<string>",
  "status_page_id": "<string>",
  "components": [
    {}
  ]
}
'
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "API outage",
    "type": "incident",
    "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"
  }
}
Requires incidents:read_write permission. Create an incident to communicate a service disruption. Optionally publish to a status page with affected components in the same call.
​
title
string
required
Incident title (1–255 characters)
​
type
string
default:"incident"
incident or maintenance
​
impact
string
default:"major"
minor, major, or critical
​
message
string
Initial timeline message. If omitted, the incident is created with a default message.
​
status_page_id
string
UUID of the status page to publish to. Must be used together with components.
​
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).
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "API outage",
    "type": "incident",
    "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"
  }
}