Skip to main content
POST
Create an alert

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
display_name
string
required

Workspace-unique display name.

project_id
string
required

Project that owns the alert. Required.

query
object
required

Metric query evaluated on each tick.

condition
object
required

Threshold condition applied to the query result.

description
string

Short human-readable summary of what the alert watches.

signal
string

UI signal preset the alert is created from. Defaults to custom.

notifier_ids
string[]

Notifiers that receive trigger-open and trigger-resolve notifications.

enabled
boolean

Whether the alert starts evaluating immediately. Defaults to true.

Response

200 - application/json

OK

alert
object
required

Newly created alert.