---
title: "POST /api/agent/realtime-alerts"
method: POST
path: "/api/agent/realtime-alerts"
tags: ["agent"]
---

# POST /api/agent/realtime-alerts

`POST /api/agent/realtime-alerts`

## Request

- Base URL: `https://api.blackforge.so` (the document declares no server; this is the origin it was published from)
- URL: `https://api.blackforge.so/api/agent/realtime-alerts`
- Auth: HTTP bearer

## Request body

- CreateAgentAlertDto
  - `formulaId` string, required: The formula to watch (`fml_…`).
  - `direction` 'above' | 'below' | 'cross', required
  - `threshold` number, required: The value you set.
  - `hysteresis` number: How far back across the value the formula must move before it can notify again. Absolute, default 0.
  - `cooldownSeconds` number: Seconds before it can notify again, 60 to 86400. Default 900.
  - `email` boolean: Email the account's verified address. Default true. The address is never an argument.

## Response `201`

---

[API](https://skmtc.dev/blackforge/apis/blackforge-data-api.md) · [All operations](https://skmtc.dev/blackforge/apis/blackforge-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blackforge/apis/blackforge-data-api/revisions/04eadd230b1b?raw)