---
title: "Summarise Alert"
method: POST
path: "/alerts/summary"
tags: ["Alerts"]
---

# Summarise Alert

`POST /alerts/summary`

Generate AI-powered summary for an alert.

Takes the alert message and context from Courier, enriches with
entity configuration, and returns a structured explanation with
troubleshooting guidance.

## Request body

- SummariseAlertBody — Request body for alert AI summary.
  - `alert_id` string, required — Courier message ID for tracking
  - `entity_id` string, required — Entity UUID (source/destination/pipeline)
  - `entity_type` 'sources' | 'destinations' | 'pipelines', required — Type of entity this alert is for
  - `entity_name` string, required — Human-readable entity name
  - `alert_state` 'TRIGGERED' | 'RECOVERED', required — Current alert state (normalized from input)
  - `alert_message` string, required — Alert message content from Courier inbox
  - `trigger_type` 'connector_status' | 'latency' | 'lag' | 'no_records' | 'dlq' | 'json_column_detected' | 'transform_status' | 'config_changed', nullable — Type of trigger that caused this alert (optional - history fetched for all types if omitted)
  - `alert_datetime` string, required — When alert was triggered (from Courier payload)

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/streamkap/apis/streamkap-rest-api.md) · [All operations](https://skmtc.net/streamkap/apis/streamkap-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streamkap/streamkap-rest-api/versions/8aea6143d003/schema)