# Create a new alarm filter to monitor events and trigger notifications

Requires alarms::modify permission.

Endpoint: POST /v2/alarm
Version: 1.0.0
Security: JWTAuthorizer

## Request fields (application/json):

  - `channels` (array)
    Channel IDs to broadcast alerts to

  - `description` (string)

  - `freetext` (string)
    text to match

  - `name` (string, required)

  - `nodes` (array)
    Node names to match

  - `operator` (string)
    Logical operator for criteria matching
    Enum: "any", "all", "none"

  - `tags` (array)
    Tags expressed as key=value to match

  - `tagsOperator` (string)
    How tag criteria should match
    Enum: "any", "all"

  - `threshold` (string)
    Event threshold to match
    Enum: "INFO", "WARNING", "ERROR", "CRITICAL"

  - `expr` (string)
    CEL expression to match

  - `types` (array)
    Event types to match

  - `uid` (string)


## Response 200 fields