Skip to main content

Documentation index for AI agents: llms.txt. Every page here is also served as markdown: add .md to its address, or request it with Accept: text/markdown.

AlertRule data model

An alert rule. Rules watch one monitor and evaluate response time or uptime conditions on its checks.

Fields

FieldTypeRequiredDescription
idstring (uuid)Yes
organizationIdstring (uuid)No
monitorIdstring (uuid) or null (uuid)NoThe monitor this rule watches. Older rules without a monitor never run (supported: false).
namestringYes
descriptionstring or nullNo
enabledbooleanYes
conditionsanyYesThe conditions as stored: one condition object or a list that must all be true. See CreateAlertRuleRequest for the accepted shapes. Rules saved earlier with other condition types are returned as stored, with supported: false.
severitystringNoOne of: INFO, WARNING, CRITICAL.
thresholdintegerNo
windowintegerNoSeconds.
cooldownMinutesintegerNoMinimum minutes between two notifications from this rule.
scheduleStartstring or nullNo24h HH:MM. With scheduleEnd, the rule only alerts inside this window.
scheduleEndstring or nullNo24h HH:MM.
timezonestringNoIANA timezone for the schedule window.
supportedbooleanYesFalse when the rule can never run: it has no monitor, or a condition alert rules do not evaluate. Unsupported rules are never evaluated.
unsupportedReasonstring or nullYesWhy the rule is not supported, in plain words. Null when supported.
monitorobject or nullNo
monitor.idstring (uuid)No
monitor.namestringNo
monitor.urlstringNo
notificationChannelsarray of objectNo
notificationChannels[].idstring (uuid)No
notificationChannels[].namestringNo
notificationChannels[].typestringNo
notificationChannels[].enabledbooleanNo
createdAtstring (date-time)No
updatedAtstring (date-time)No

Used by

Generated from the OpenAPI 3.1 specification at https://docs.visualsentinel.com/openapi.json.