---
title: "Fire an alert"
method: POST
path: "/v1/alerts"
tags: ["Alerts"]
---

# Fire an alert

`POST /v1/alerts`

Create a new alert. `critical` severity automatically creates an incident ticket with a 1h SLA and broadcasts to all SSE clients. All alerts trigger push + ntfy notifications if the user has a topic configured.

## Request body

- object
  - `title` string, required
  - `body` string
  - `severity` 'info' | 'warning' | 'critical'
  - `source` 'api' | 'webhook' | 'sensor' | 'noaa' | 'booking' | 'scheduled'
  - `source_ref` string — External reference (sensor ID, webhook ID, etc.)
  - `org_id` integer, nullable
  - `lat` number, nullable
  - `lng` number, nullable
  - `location_name` string, nullable
  - `meta` object, nullable

## Response `201`

Default Response

- object

---

[API](https://skmtc.net/schedkit/apis/schedkit-api.md) · [All operations](https://skmtc.net/schedkit/apis/schedkit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/schedkit/schedkit-api/revisions/ff810218c3f4/schema)