v2

latestOpenAPI 3.0.02026-08-073221853.1 MB

Alerts

Create Topline Alert

post/console/v1/alerts

Request body

namestring required

Name of the alert (4-100 characters)

messagestring

Alert message shown when the alert fires

teamIDstring

ID of the team that owns this alert

formulastring

Formula expression combining the alert metrics

definitionMetricsJsonstring[]

JSON-encoded metric definitions evaluated by the alert. Each entry is a stringified ToplineAlertMExDefinitionOrUnresolved.

Response

Create Alert success response

messagestring required

A simple string explaining the result of the operation.

Example response

{
  "data": {
    "owner": {
      "ownerID": "user123",
      "ownerType": "USER",
      "ownerName": "John Doe",
      "ownerEmail": "owner123@test.com"
    }
  }
}