Create rule

POST 
/rules

Create rule.

Authorization Action:

ruleengine:rules:create

Request

application/json

Body

required

name stringrequired
severity string

Possible values: [info, warning, critical]

description string
processable string

Possible values: [enabled, disabled]

Default value: enabled

tags object[]
Array [
label stringrequired
labelValue stringrequired
metadata object
Other custom properties associated to the tag
]
notification objectrequired
messages object[]required
Array [
target string
Notification target: can be an email address, a phone number or a telegram account. If not specified, the notification target is set to the user that created the rule.
policy stringrequired
Possible values: [trigger, reentry]
medium stringrequired
Possible values: [email, telegram, sms, slack, discord, fcm, msteams]
text stringrequired
]
conditions object[]required
Array [
params objectrequired
oneOf
ThresholdConditionParamsDto
metric stringrequired
URN of the metric to be monitored
threshold numberrequired
comparisonOperator stringrequired
Possible values: [>, >=, <, <=, ==, !=]
unit string
durationSecs numberrequired
Possible values: <= 86400
activeWindow object
from stringrequired
Possible values: Value must match regular expression /^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$/
to stringrequired
Possible values: Value must match regular expression /^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$/
timezone stringrequired
IANA timezone identifier
LastMessageOlderThanConditionParamsDto
channelId stringrequired
durationSecs numberrequired
Possible values: <= 86400
activeWindow object
from stringrequired
Possible values: Value must match regular expression /^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$/
to stringrequired
Possible values: Value must match regular expression /^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$/
timezone stringrequired
IANA timezone identifier
DeltaConditionParamsDto
delta numberrequired
metric stringrequired
URN of the metric to be monitored
comparisonOperator stringrequired
Possible values: [>, >=, <, <=, ==, !=]
unit string
durationSecs numberrequired
Possible values: <= 86400
activeWindow object
from stringrequired
Possible values: Value must match regular expression /^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$/
to stringrequired
Possible values: Value must match regular expression /^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$/
timezone stringrequired
IANA timezone identifier
type stringrequired
Possible values: [threshold, lastMessageOlderThan, delta]
]

Responses

201

application/json

Schema

Schema

conditions object[]required
Array [
params objectrequired
oneOf
ThresholdConditionParamsDto
metric stringrequired
URN of the metric to be monitored
threshold numberrequired
comparisonOperator stringrequired
Possible values: [>, >=, <, <=, ==, !=]
unit string
durationSecs numberrequired
Possible values: <= 86400
activeWindow object
from stringrequired
Possible values: Value must match regular expression /^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$/
to stringrequired
Possible values: Value must match regular expression /^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$/
timezone stringrequired
IANA timezone identifier
LastMessageOlderThanConditionParamsDto
channelId stringrequired
durationSecs numberrequired
Possible values: <= 86400
activeWindow object
from stringrequired
Possible values: Value must match regular expression /^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$/
to stringrequired
Possible values: Value must match regular expression /^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$/
timezone stringrequired
IANA timezone identifier
DeltaConditionParamsDto
delta numberrequired
metric stringrequired
URN of the metric to be monitored
comparisonOperator stringrequired
Possible values: [>, >=, <, <=, ==, !=]
unit string
durationSecs numberrequired
Possible values: <= 86400
activeWindow object
from stringrequired
Possible values: Value must match regular expression /^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$/
to stringrequired
Possible values: Value must match regular expression /^(0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$/
timezone stringrequired
IANA timezone identifier
status stringrequired
Possible values: [active, inactive]
createdAt date-timerequired
updatedAt date-timerequired
deletedAt date-timerequired
type stringrequired
Possible values: [threshold, lastMessageOlderThan, delta]
id stringrequired
]
tags object[]required
Array [
createdAt date-timerequired
updatedAt date-timerequired
deletedAt date-timerequired
label stringrequired
labelValue stringrequired
metadata object
Other custom properties associated to the tag
id stringrequired
]
status stringrequired

Possible values: [active, inactive]

createdAt date-timerequired
updatedAt date-timerequired
deletedAt date-timerequired
name stringrequired
severity string

Possible values: [info, warning, critical]

description string
processable string

Possible values: [enabled, disabled]

Default value: enabled

notification objectrequired
messages object[]required
Array [
target string
Notification target: can be an email address, a phone number or a telegram account. If not specified, the notification target is set to the user that created the rule.
policy stringrequired
Possible values: [trigger, reentry]
medium stringrequired
Possible values: [email, telegram, sms, slack, discord, fcm, msteams]
text stringrequired
]
id stringrequired

Example (from schema)

{
  "conditions": [
    {
      "params": {},
      "status": "active",
      "createdAt": "2024-08-30T08:48:05.877Z",
      "updatedAt": "2024-08-30T08:48:05.877Z",
      "deletedAt": "2024-08-30T08:48:05.877Z",
      "type": "threshold",
      "id": "string"
    }
  ],
  "tags": [
    {
      "createdAt": "2024-08-30T08:48:05.877Z",
      "updatedAt": "2024-08-30T08:48:05.877Z",
      "deletedAt": "2024-08-30T08:48:05.877Z",
      "label": "string",
      "labelValue": "string",
      "metadata": {},
      "id": "string"
    }
  ],
  "status": "active",
  "createdAt": "2024-08-30T08:48:05.877Z",
  "updatedAt": "2024-08-30T08:48:05.877Z",
  "deletedAt": "2024-08-30T08:48:05.877Z",
  "name": "string",
  "severity": "info",
  "description": "string",
  "processable": "enabled",
  "notification": {
    "messages": [
      {
        "target": "string",
        "policy": "trigger",
        "medium": "email",
        "text": "string"
      }
    ]
  },
  "id": "string"
}

400

Missing user identity id

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X POST 'https://connhex.com/rules' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "name": "string",
  "severity": "info",
  "description": "string",
  "processable": "enabled",
  "tags": [
    {
      "label": "string",
      "labelValue": "string",
      "metadata": {}
    }
  ],
  "notification": {
    "messages": [
      {
        "target": "string",
        "policy": "trigger",
        "medium": "email",
        "text": "string"
      }
    ]
  },
  "conditions": [
    {
      "params": {
        "metric": "urn:cpt:smartdevice:nid:D0CF5EFFFE26FDAB1:onoff",
        "threshold": 0,
        "comparisonOperator": ">",
        "unit": "°C",
        "durationSecs": 0,
        "activeWindow": {
          "from": "08:10",
          "to": "13:15",
          "timezone": "Europe/Rome"
        }
      },
      "type": "threshold"
    }
  ]
}'

Request Collapse all

Body required

{
  "name": "string",
  "severity": "info",
  "description": "string",
  "processable": "enabled",
  "tags": [
    {
      "label": "string",
      "labelValue": "string",
      "metadata": {}
    }
  ],
  "notification": {
    "messages": [
      {
        "target": "string",
        "policy": "trigger",
        "medium": "email",
        "text": "string"
      }
    ]
  },
  "conditions": [
    {
      "params": {
        "metric": "urn:cpt:smartdevice:nid:D0CF5EFFFE26FDAB1:onoff",
        "threshold": 0,
        "comparisonOperator": ">",
        "unit": "°C",
        "durationSecs": 0,
        "activeWindow": {
          "from": "08:10",
          "to": "13:15",
          "timezone": "Europe/Rome"
        }
      },
      "type": "threshold"
    }
  ]
}