Alert Actions

Get available actions for specified alert.

get
Authorizations
Path parameters
idnumberRequired

entity ID

Responses
200
list of alert actions
application/json
get
GET /api/alerts/{id}/actions HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
200

list of alert actions

{
  "alertActionId": "text",
  "connectorId": "text",
  "type": "text",
  "name": "text",
  "iconUrl": "text",
  "history": [
    {
      "id": "text",
      "alertActionId": "text",
      "connectorId": "text",
      "alertId": 1,
      "success": true,
      "actor": {
        "id": 1,
        "firstName": "text",
        "lastName": "text",
        "email": "text",
        "timezone": "Europe/Berlin",
        "position": "text",
        "department": "text",
        "avatarUrl": "text",
        "language": "de",
        "region": "DE",
        "role": "STAKEHOLDER",
        "shiftColor": "text",
        "mutedUntil": "2025-07-08T10:56:26.963Z",
        "createdAt": "2025-07-08T10:56:26.963Z",
        "updatedAt": "2025-07-08T10:56:26.963Z"
      }
    }
  ]
}

Invoke a specific alert action.

post
Authorizations
Path parameters
idnumberRequired

entity ID

Body
alertActionIdstringOptional
connectorIdstringOptional
typestringOptional
namestringOptional
iconUrlstringOptional
Responses
201
the alert action result, validate the 'success' field
application/json
post
POST /api/alerts/{id}/actions HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 510

{
  "alertActionId": "text",
  "connectorId": "text",
  "type": "text",
  "name": "text",
  "iconUrl": "text",
  "history": [
    {
      "id": "text",
      "alertActionId": "text",
      "connectorId": "text",
      "alertId": 1,
      "success": true,
      "actor": {
        "id": 1,
        "firstName": "text",
        "lastName": "text",
        "email": "text",
        "timezone": "Europe/Berlin",
        "position": "text",
        "department": "text",
        "language": "de",
        "region": "DE",
        "role": "STAKEHOLDER",
        "shiftColor": "text",
        "mutedUntil": "2025-07-08T10:56:26.963Z",
        "createdAt": "2025-07-08T10:56:26.963Z",
        "updatedAt": "2025-07-08T10:56:26.963Z"
      }
    }
  ]
}
201

the alert action result, validate the 'success' field

{
  "id": "text",
  "alertActionId": "text",
  "connectorId": "text",
  "alertId": 1,
  "success": true,
  "actor": {
    "id": 1,
    "firstName": "text",
    "lastName": "text",
    "email": "text",
    "timezone": "Europe/Berlin",
    "position": "text",
    "department": "text",
    "avatarUrl": "text",
    "language": "de",
    "region": "DE",
    "role": "STAKEHOLDER",
    "shiftColor": "text",
    "mutedUntil": "2025-07-08T10:56:26.963Z",
    "createdAt": "2025-07-08T10:56:26.963Z",
    "updatedAt": "2025-07-08T10:56:26.963Z"
  }
}

Get alert actions.

get
Authorizations
Query parameters
sourcenumberOptional

alert source id

connectorstringOptional

connector id

start-indexinteger · int32Optional

an integer specifying the starting point (beginning with 0) when paging through a list of entities

Default: 0
max-resultsinteger · int32 · max: 100Optional

the maximum number of results when paging through a list of alert actions.

Default: 100
Responses
200
The filtered alert actions
application/json
get
GET /api/alert-actions HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
200

The filtered alert actions

[
  {
    "id": "text",
    "alertSources": [
      {
        "id": 1,
        "teams": [
          {
            "id": 1,
            "name": "text"
          }
        ],
        "name": "text",
        "iconUrl": "text",
        "lightIconUrl": "text",
        "darkIconUrl": "text",
        "escalationPolicy": {
          "id": 1,
          "name": "text",
          "escalationRules": [
            {
              "escalationTimeout": 1,
              "user": {
                "id": 1
              },
              "schedule": {
                "id": 1
              },
              "users": [
                {
                  "id": 1,
                  "firstName": "text",
                  "lastName": "text"
                }
              ],
              "schedules": [
                {
                  "id": 1,
                  "name": "text",
                  "type": "STATIC"
                }
              ]
            }
          ],
          "teams": [
            {
              "id": 1,
              "name": "text"
            }
          ],
          "repeating": false,
          "frequency": 1,
          "delayMin": 0,
          "routingKey": "text"
        },
        "integrationType": "NAGIOS",
        "integrationKey": "text",
        "integrationUrl": "text",
        "autoResolutionTimeout": "text",
        "alertGroupingWindow": "text",
        "alertCreation": "ONE_ALERT_PER_EMAIL",
        "status": "PENDING",
        "active": true,
        "alertPriorityRule": "HIGH",
        "supportHours": {
          "id": 1,
          "name": "text",
          "teams": [
            {
              "id": 1,
              "name": "text"
            }
          ],
          "timezone": "Europe/Berlin",
          "supportDays": {
            "MONDAY": {
              "start": "10:56:26",
              "end": "10:56:26"
            },
            "TUESDAY": {
              "start": "10:56:26",
              "end": "10:56:26"
            },
            "WEDNESDAY": {
              "start": "10:56:26",
              "end": "10:56:26"
            },
            "THURSDAY": {
              "start": "10:56:26",
              "end": "10:56:26"
            },
            "FRIDAY": {
              "start": "10:56:26",
              "end": "10:56:26"
            },
            "SATURDAY": {
              "start": "10:56:26",
              "end": "10:56:26"
            },
            "SUNDAY": {
              "start": "10:56:26",
              "end": "10:56:26"
            }
          }
        },
        "bidirectional": true,
        "summaryTemplate": {
          "textTemplate": "text",
          "elements": [
            {
              "type": "TEXT",
              "val": "text",
              "func": "text",
              "args": [
                {
                  "S": "text",
                  "N": 1
                }
              ]
            }
          ]
        },
        "detailsTemplate": {
          "textTemplate": "text",
          "elements": [
            {
              "type": "TEXT",
              "val": "text",
              "func": "text",
              "args": [
                {
                  "S": "text",
                  "N": 1
                }
              ]
            }
          ]
        },
        "routingTemplate": {
          "textTemplate": "text",
          "elements": [
            {
              "type": "TEXT",
              "val": "text",
              "func": "text",
              "args": [
                {
                  "S": "text",
                  "N": 1
                }
              ]
            }
          ]
        },
        "linkTemplates": [
          {
            "text": "text",
            "hrefTemplate": {
              "textTemplate": "text",
              "elements": [
                {
                  "type": "TEXT",
                  "val": "text",
                  "func": "text",
                  "args": [
                    {
                      "S": "text",
                      "N": 1
                    }
                  ]
                }
              ]
            }
          }
        ],
        "priorityTemplate": {
          "valueTemplate": {
            "textTemplate": "text",
            "elements": [
              {
                "type": "TEXT",
                "val": "text",
                "func": "text",
                "args": [
                  {
                    "S": "text",
                    "N": 1
                  }
                ]
              }
            ]
          },
          "mappings": [
            {
              "value": "text",
              "priority": "LOW"
            }
          ]
        },
        "eventFilter": "text",
        "alertKeyTemplate": {
          "textTemplate": "text",
          "elements": [
            {
              "type": "TEXT",
              "val": "text",
              "func": "text",
              "args": [
                {
                  "S": "text",
                  "N": 1
                }
              ]
            }
          ]
        },
        "eventTypeFilterCreate": "text",
        "eventTypeFilterAccept": "text",
        "eventTypeFilterResolve": "text"
      }
    ],
    "connectorId": "text",
    "connectorType": "autotask",
    "name": "text",
    "createdAt": "2025-07-08T10:56:26.963Z",
    "updatedAt": "2025-07-08T10:56:26.963Z",
    "triggerMode": "AUTOMATIC",
    "bidirectional": true,
    "escalationEndedDelaySec": 1,
    "notResolvedDelaySec": 1,
    "triggerTypes": [
      "alert-created"
    ],
    "alertFilter": {
      "operator": "AND",
      "predicates": [
        {
          "field": "ALERT_SUMMARY",
          "criteria": "CONTAINS_ANY_WORDS",
          "value": "text"
        }
      ]
    },
    "conditions": "text",
    "params": {
      "tags": [
        "text"
      ],
      "priority": "text",
      "site": "text"
    },
    "teams": [
      {
        "id": 1,
        "name": "text"
      }
    ]
  }
]

Create a new alert action.

post
Authorizations
Body
idstringOptional
connectorIdstringOptional
connectorTypestring · enumRequiredPossible values:
namestringRequired
createdAtstring · date-timeOptional
updatedAtstring · date-timeOptional
triggerModestring · enumOptionalPossible values:
bidirectionalbooleanRead-onlyOptional
escalationEndedDelaySecnumber · max: 7200Optional

May only be used with triggerType 'alert-escalation-ended' selected

notResolvedDelaySecnumber · max: 7200Optional

May only be used with triggerType 'v-alert-not-resolved' selected

conditionsstringOptional

Defines an optional alert filter condition in ICL language. This is a code based implementation, more info on syntax: https://docs.ilert.com/rest-api/icl-ilert-condition-language. For block based configuration please use the web UI. Note: this field is an ?include, it will not appear in lists.

paramsone ofOptional
or
or
or
objectOptional
or
or
or
or
or
or
objectOptional
or
or
or
or
or
or
or
or
or
or
or
or
or
or
or
or
Responses
200
The newly created alert action
application/json
post
POST /api/alert-actions HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2569

{
  "id": "text",
  "alertSources": [
    {
      "id": 1,
      "teams": [
        {
          "id": 1,
          "name": "text"
        }
      ],
      "name": "text",
      "iconUrl": "text",
      "lightIconUrl": "text",
      "darkIconUrl": "text",
      "escalationPolicy": {
        "id": 1,
        "name": "text",
        "escalationRules": [
          {
            "escalationTimeout": 1,
            "user": {
              "id": 1
            },
            "schedule": {
              "id": 1
            },
            "users": [
              {
                "id": 1,
                "firstName": "text",
                "lastName": "text"
              }
            ],
            "schedules": [
              {
                "id": 1,
                "name": "text",
                "type": "STATIC"
              }
            ]
          }
        ],
        "teams": [
          {
            "id": 1,
            "name": "text"
          }
        ],
        "repeating": false,
        "frequency": 1,
        "delayMin": 0,
        "routingKey": "text"
      },
      "integrationType": "NAGIOS",
      "integrationKey": "text",
      "autoResolutionTimeout": "text",
      "alertGroupingWindow": "text",
      "alertCreation": "ONE_ALERT_PER_EMAIL",
      "active": true,
      "alertPriorityRule": "HIGH",
      "supportHours": {
        "id": 1,
        "name": "text",
        "teams": [
          {
            "id": 1,
            "name": "text"
          }
        ],
        "timezone": "Europe/Berlin",
        "supportDays": {
          "MONDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "TUESDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "WEDNESDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "THURSDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "FRIDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "SATURDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "SUNDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          }
        }
      },
      "summaryTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "detailsTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "routingTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "linkTemplates": [
        {
          "text": "text",
          "hrefTemplate": {
            "textTemplate": "text",
            "elements": [
              {
                "type": "TEXT",
                "val": "text",
                "func": "text",
                "args": [
                  {
                    "S": "text",
                    "N": 1
                  }
                ]
              }
            ]
          }
        }
      ],
      "priorityTemplate": {
        "valueTemplate": {
          "textTemplate": "text",
          "elements": [
            {
              "type": "TEXT",
              "val": "text",
              "func": "text",
              "args": [
                {
                  "S": "text",
                  "N": 1
                }
              ]
            }
          ]
        },
        "mappings": [
          {
            "value": "text",
            "priority": "LOW"
          }
        ]
      },
      "eventFilter": "text",
      "alertKeyTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "eventTypeFilterCreate": "text",
      "eventTypeFilterAccept": "text",
      "eventTypeFilterResolve": "text"
    }
  ],
  "connectorId": "text",
  "connectorType": "autotask",
  "name": "text",
  "createdAt": "2025-07-08T10:56:26.963Z",
  "updatedAt": "2025-07-08T10:56:26.963Z",
  "triggerMode": "AUTOMATIC",
  "escalationEndedDelaySec": 1,
  "notResolvedDelaySec": 1,
  "triggerTypes": [
    "alert-created"
  ],
  "alertFilter": {
    "operator": "AND",
    "predicates": [
      {
        "field": "ALERT_SUMMARY",
        "criteria": "CONTAINS_ANY_WORDS",
        "value": "text"
      }
    ]
  },
  "conditions": "text",
  "params": {
    "tags": [
      "text"
    ],
    "priority": "text",
    "site": "text"
  },
  "teams": [
    {
      "id": 1,
      "name": "text"
    }
  ]
}
200

The newly created alert action

{
  "id": "text",
  "alertSources": [
    {
      "id": 1,
      "teams": [
        {
          "id": 1,
          "name": "text"
        }
      ],
      "name": "text",
      "iconUrl": "text",
      "lightIconUrl": "text",
      "darkIconUrl": "text",
      "escalationPolicy": {
        "id": 1,
        "name": "text",
        "escalationRules": [
          {
            "escalationTimeout": 1,
            "user": {
              "id": 1
            },
            "schedule": {
              "id": 1
            },
            "users": [
              {
                "id": 1,
                "firstName": "text",
                "lastName": "text"
              }
            ],
            "schedules": [
              {
                "id": 1,
                "name": "text",
                "type": "STATIC"
              }
            ]
          }
        ],
        "teams": [
          {
            "id": 1,
            "name": "text"
          }
        ],
        "repeating": false,
        "frequency": 1,
        "delayMin": 0,
        "routingKey": "text"
      },
      "integrationType": "NAGIOS",
      "integrationKey": "text",
      "integrationUrl": "text",
      "autoResolutionTimeout": "text",
      "alertGroupingWindow": "text",
      "alertCreation": "ONE_ALERT_PER_EMAIL",
      "status": "PENDING",
      "active": true,
      "alertPriorityRule": "HIGH",
      "supportHours": {
        "id": 1,
        "name": "text",
        "teams": [
          {
            "id": 1,
            "name": "text"
          }
        ],
        "timezone": "Europe/Berlin",
        "supportDays": {
          "MONDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "TUESDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "WEDNESDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "THURSDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "FRIDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "SATURDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "SUNDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          }
        }
      },
      "bidirectional": true,
      "summaryTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "detailsTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "routingTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "linkTemplates": [
        {
          "text": "text",
          "hrefTemplate": {
            "textTemplate": "text",
            "elements": [
              {
                "type": "TEXT",
                "val": "text",
                "func": "text",
                "args": [
                  {
                    "S": "text",
                    "N": 1
                  }
                ]
              }
            ]
          }
        }
      ],
      "priorityTemplate": {
        "valueTemplate": {
          "textTemplate": "text",
          "elements": [
            {
              "type": "TEXT",
              "val": "text",
              "func": "text",
              "args": [
                {
                  "S": "text",
                  "N": 1
                }
              ]
            }
          ]
        },
        "mappings": [
          {
            "value": "text",
            "priority": "LOW"
          }
        ]
      },
      "eventFilter": "text",
      "alertKeyTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "eventTypeFilterCreate": "text",
      "eventTypeFilterAccept": "text",
      "eventTypeFilterResolve": "text"
    }
  ],
  "connectorId": "text",
  "connectorType": "autotask",
  "name": "text",
  "createdAt": "2025-07-08T10:56:26.963Z",
  "updatedAt": "2025-07-08T10:56:26.963Z",
  "triggerMode": "AUTOMATIC",
  "bidirectional": true,
  "escalationEndedDelaySec": 1,
  "notResolvedDelaySec": 1,
  "triggerTypes": [
    "alert-created"
  ],
  "alertFilter": {
    "operator": "AND",
    "predicates": [
      {
        "field": "ALERT_SUMMARY",
        "criteria": "CONTAINS_ANY_WORDS",
        "value": "text"
      }
    ]
  },
  "conditions": "text",
  "params": {
    "tags": [
      "text"
    ],
    "priority": "text",
    "site": "text"
  },
  "teams": [
    {
      "id": 1,
      "name": "text"
    }
  ]
}

Get a specific alert action.

get
Authorizations
Path parameters
idstringRequired

entity ID

Query parameters
Responses
200
The requested alert action
application/json
get
GET /api/alert-actions/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
200

The requested alert action

{
  "id": "text",
  "alertSources": [
    {
      "id": 1,
      "teams": [
        {
          "id": 1,
          "name": "text"
        }
      ],
      "name": "text",
      "iconUrl": "text",
      "lightIconUrl": "text",
      "darkIconUrl": "text",
      "escalationPolicy": {
        "id": 1,
        "name": "text",
        "escalationRules": [
          {
            "escalationTimeout": 1,
            "user": {
              "id": 1
            },
            "schedule": {
              "id": 1
            },
            "users": [
              {
                "id": 1,
                "firstName": "text",
                "lastName": "text"
              }
            ],
            "schedules": [
              {
                "id": 1,
                "name": "text",
                "type": "STATIC"
              }
            ]
          }
        ],
        "teams": [
          {
            "id": 1,
            "name": "text"
          }
        ],
        "repeating": false,
        "frequency": 1,
        "delayMin": 0,
        "routingKey": "text"
      },
      "integrationType": "NAGIOS",
      "integrationKey": "text",
      "integrationUrl": "text",
      "autoResolutionTimeout": "text",
      "alertGroupingWindow": "text",
      "alertCreation": "ONE_ALERT_PER_EMAIL",
      "status": "PENDING",
      "active": true,
      "alertPriorityRule": "HIGH",
      "supportHours": {
        "id": 1,
        "name": "text",
        "teams": [
          {
            "id": 1,
            "name": "text"
          }
        ],
        "timezone": "Europe/Berlin",
        "supportDays": {
          "MONDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "TUESDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "WEDNESDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "THURSDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "FRIDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "SATURDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "SUNDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          }
        }
      },
      "bidirectional": true,
      "summaryTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "detailsTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "routingTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "linkTemplates": [
        {
          "text": "text",
          "hrefTemplate": {
            "textTemplate": "text",
            "elements": [
              {
                "type": "TEXT",
                "val": "text",
                "func": "text",
                "args": [
                  {
                    "S": "text",
                    "N": 1
                  }
                ]
              }
            ]
          }
        }
      ],
      "priorityTemplate": {
        "valueTemplate": {
          "textTemplate": "text",
          "elements": [
            {
              "type": "TEXT",
              "val": "text",
              "func": "text",
              "args": [
                {
                  "S": "text",
                  "N": 1
                }
              ]
            }
          ]
        },
        "mappings": [
          {
            "value": "text",
            "priority": "LOW"
          }
        ]
      },
      "eventFilter": "text",
      "alertKeyTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "eventTypeFilterCreate": "text",
      "eventTypeFilterAccept": "text",
      "eventTypeFilterResolve": "text"
    }
  ],
  "connectorId": "text",
  "connectorType": "autotask",
  "name": "text",
  "createdAt": "2025-07-08T10:56:26.963Z",
  "updatedAt": "2025-07-08T10:56:26.963Z",
  "triggerMode": "AUTOMATIC",
  "bidirectional": true,
  "escalationEndedDelaySec": 1,
  "notResolvedDelaySec": 1,
  "triggerTypes": [
    "alert-created"
  ],
  "alertFilter": {
    "operator": "AND",
    "predicates": [
      {
        "field": "ALERT_SUMMARY",
        "criteria": "CONTAINS_ANY_WORDS",
        "value": "text"
      }
    ]
  },
  "conditions": "text",
  "params": {
    "tags": [
      "text"
    ],
    "priority": "text",
    "site": "text"
  },
  "teams": [
    {
      "id": 1,
      "name": "text"
    }
  ]
}

Update the specific alert action. (note: type cannot be changed)

put
Authorizations
Path parameters
idstringRequired

entity ID

Body
idstringOptional
connectorIdstringOptional
connectorTypestring · enumRequiredPossible values:
namestringRequired
createdAtstring · date-timeOptional
updatedAtstring · date-timeOptional
triggerModestring · enumOptionalPossible values:
bidirectionalbooleanRead-onlyOptional
escalationEndedDelaySecnumber · max: 7200Optional

May only be used with triggerType 'alert-escalation-ended' selected

notResolvedDelaySecnumber · max: 7200Optional

May only be used with triggerType 'v-alert-not-resolved' selected

conditionsstringOptional

Defines an optional alert filter condition in ICL language. This is a code based implementation, more info on syntax: https://docs.ilert.com/rest-api/icl-ilert-condition-language. For block based configuration please use the web UI. Note: this field is an ?include, it will not appear in lists.

paramsone ofOptional
or
or
or
objectOptional
or
or
or
or
or
or
objectOptional
or
or
or
or
or
or
or
or
or
or
or
or
or
or
or
or
Responses
200
The updated alert action
application/json
put
PUT /api/alert-actions/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2569

{
  "id": "text",
  "alertSources": [
    {
      "id": 1,
      "teams": [
        {
          "id": 1,
          "name": "text"
        }
      ],
      "name": "text",
      "iconUrl": "text",
      "lightIconUrl": "text",
      "darkIconUrl": "text",
      "escalationPolicy": {
        "id": 1,
        "name": "text",
        "escalationRules": [
          {
            "escalationTimeout": 1,
            "user": {
              "id": 1
            },
            "schedule": {
              "id": 1
            },
            "users": [
              {
                "id": 1,
                "firstName": "text",
                "lastName": "text"
              }
            ],
            "schedules": [
              {
                "id": 1,
                "name": "text",
                "type": "STATIC"
              }
            ]
          }
        ],
        "teams": [
          {
            "id": 1,
            "name": "text"
          }
        ],
        "repeating": false,
        "frequency": 1,
        "delayMin": 0,
        "routingKey": "text"
      },
      "integrationType": "NAGIOS",
      "integrationKey": "text",
      "autoResolutionTimeout": "text",
      "alertGroupingWindow": "text",
      "alertCreation": "ONE_ALERT_PER_EMAIL",
      "active": true,
      "alertPriorityRule": "HIGH",
      "supportHours": {
        "id": 1,
        "name": "text",
        "teams": [
          {
            "id": 1,
            "name": "text"
          }
        ],
        "timezone": "Europe/Berlin",
        "supportDays": {
          "MONDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "TUESDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "WEDNESDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "THURSDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "FRIDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "SATURDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "SUNDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          }
        }
      },
      "summaryTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "detailsTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "routingTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "linkTemplates": [
        {
          "text": "text",
          "hrefTemplate": {
            "textTemplate": "text",
            "elements": [
              {
                "type": "TEXT",
                "val": "text",
                "func": "text",
                "args": [
                  {
                    "S": "text",
                    "N": 1
                  }
                ]
              }
            ]
          }
        }
      ],
      "priorityTemplate": {
        "valueTemplate": {
          "textTemplate": "text",
          "elements": [
            {
              "type": "TEXT",
              "val": "text",
              "func": "text",
              "args": [
                {
                  "S": "text",
                  "N": 1
                }
              ]
            }
          ]
        },
        "mappings": [
          {
            "value": "text",
            "priority": "LOW"
          }
        ]
      },
      "eventFilter": "text",
      "alertKeyTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "eventTypeFilterCreate": "text",
      "eventTypeFilterAccept": "text",
      "eventTypeFilterResolve": "text"
    }
  ],
  "connectorId": "text",
  "connectorType": "autotask",
  "name": "text",
  "createdAt": "2025-07-08T10:56:26.963Z",
  "updatedAt": "2025-07-08T10:56:26.963Z",
  "triggerMode": "AUTOMATIC",
  "escalationEndedDelaySec": 1,
  "notResolvedDelaySec": 1,
  "triggerTypes": [
    "alert-created"
  ],
  "alertFilter": {
    "operator": "AND",
    "predicates": [
      {
        "field": "ALERT_SUMMARY",
        "criteria": "CONTAINS_ANY_WORDS",
        "value": "text"
      }
    ]
  },
  "conditions": "text",
  "params": {
    "tags": [
      "text"
    ],
    "priority": "text",
    "site": "text"
  },
  "teams": [
    {
      "id": 1,
      "name": "text"
    }
  ]
}
200

The updated alert action

{
  "id": "text",
  "alertSources": [
    {
      "id": 1,
      "teams": [
        {
          "id": 1,
          "name": "text"
        }
      ],
      "name": "text",
      "iconUrl": "text",
      "lightIconUrl": "text",
      "darkIconUrl": "text",
      "escalationPolicy": {
        "id": 1,
        "name": "text",
        "escalationRules": [
          {
            "escalationTimeout": 1,
            "user": {
              "id": 1
            },
            "schedule": {
              "id": 1
            },
            "users": [
              {
                "id": 1,
                "firstName": "text",
                "lastName": "text"
              }
            ],
            "schedules": [
              {
                "id": 1,
                "name": "text",
                "type": "STATIC"
              }
            ]
          }
        ],
        "teams": [
          {
            "id": 1,
            "name": "text"
          }
        ],
        "repeating": false,
        "frequency": 1,
        "delayMin": 0,
        "routingKey": "text"
      },
      "integrationType": "NAGIOS",
      "integrationKey": "text",
      "integrationUrl": "text",
      "autoResolutionTimeout": "text",
      "alertGroupingWindow": "text",
      "alertCreation": "ONE_ALERT_PER_EMAIL",
      "status": "PENDING",
      "active": true,
      "alertPriorityRule": "HIGH",
      "supportHours": {
        "id": 1,
        "name": "text",
        "teams": [
          {
            "id": 1,
            "name": "text"
          }
        ],
        "timezone": "Europe/Berlin",
        "supportDays": {
          "MONDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "TUESDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "WEDNESDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "THURSDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "FRIDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "SATURDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          },
          "SUNDAY": {
            "start": "10:56:26",
            "end": "10:56:26"
          }
        }
      },
      "bidirectional": true,
      "summaryTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "detailsTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "routingTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "linkTemplates": [
        {
          "text": "text",
          "hrefTemplate": {
            "textTemplate": "text",
            "elements": [
              {
                "type": "TEXT",
                "val": "text",
                "func": "text",
                "args": [
                  {
                    "S": "text",
                    "N": 1
                  }
                ]
              }
            ]
          }
        }
      ],
      "priorityTemplate": {
        "valueTemplate": {
          "textTemplate": "text",
          "elements": [
            {
              "type": "TEXT",
              "val": "text",
              "func": "text",
              "args": [
                {
                  "S": "text",
                  "N": 1
                }
              ]
            }
          ]
        },
        "mappings": [
          {
            "value": "text",
            "priority": "LOW"
          }
        ]
      },
      "eventFilter": "text",
      "alertKeyTemplate": {
        "textTemplate": "text",
        "elements": [
          {
            "type": "TEXT",
            "val": "text",
            "func": "text",
            "args": [
              {
                "S": "text",
                "N": 1
              }
            ]
          }
        ]
      },
      "eventTypeFilterCreate": "text",
      "eventTypeFilterAccept": "text",
      "eventTypeFilterResolve": "text"
    }
  ],
  "connectorId": "text",
  "connectorType": "autotask",
  "name": "text",
  "createdAt": "2025-07-08T10:56:26.963Z",
  "updatedAt": "2025-07-08T10:56:26.963Z",
  "triggerMode": "AUTOMATIC",
  "bidirectional": true,
  "escalationEndedDelaySec": 1,
  "notResolvedDelaySec": 1,
  "triggerTypes": [
    "alert-created"
  ],
  "alertFilter": {
    "operator": "AND",
    "predicates": [
      {
        "field": "ALERT_SUMMARY",
        "criteria": "CONTAINS_ANY_WORDS",
        "value": "text"
      }
    ]
  },
  "conditions": "text",
  "params": {
    "tags": [
      "text"
    ],
    "priority": "text",
    "site": "text"
  },
  "teams": [
    {
      "id": 1,
      "name": "text"
    }
  ]
}

Remove a specific alert action.

delete
Authorizations
Path parameters
idstringRequired

entity ID

Responses
204
Empty body delete response
delete
DELETE /api/alert-actions/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*
204

Empty body delete response

No content

Was this helpful?