Alert Actions

Get available actions for specified alert.

get

Authorizations

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idnumberRequired

entity ID

Responses

200

list of alert actions

application/json

get

/alerts/{id}/actions

HTTPcURLJavaScriptPython

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-12-27T23:04:39.929Z",
        "createdAt": "2025-12-27T23:04:39.929Z",
        "updatedAt": "2025-12-27T23:04:39.929Z"
      }
    }
  ]
}

Invoke a specific alert action.

post

Authorizations

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idnumberRequired

entity ID

Body

application/json

alertActionIdstringOptional

connectorIdstringOptional

typestringOptional

namestringOptional

iconUrlstringOptional

Responses

201

the alert action result, validate the 'success' field

application/json

post

/alerts/{id}/actions

HTTPcURLJavaScriptPython

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-12-27T23:04:39.929Z",
        "createdAt": "2025-12-27T23:04:39.929Z",
        "updatedAt": "2025-12-27T23:04:39.929Z"
      }
    }
  ]
}

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-12-27T23:04:39.929Z",
    "createdAt": "2025-12-27T23:04:39.929Z",
    "updatedAt": "2025-12-27T23:04:39.929Z"
  }
}

Get alert actions.

get

Authorizations

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

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

/alert-actions

HTTPcURLJavaScriptPython

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": "23:04:39",
              "end": "23:04:39"
            },
            "TUESDAY": {
              "start": "23:04:39",
              "end": "23:04:39"
            },
            "WEDNESDAY": {
              "start": "23:04:39",
              "end": "23:04:39"
            },
            "THURSDAY": {
              "start": "23:04:39",
              "end": "23:04:39"
            },
            "FRIDAY": {
              "start": "23:04:39",
              "end": "23:04:39"
            },
            "SATURDAY": {
              "start": "23:04:39",
              "end": "23:04:39"
            },
            "SUNDAY": {
              "start": "23:04:39",
              "end": "23:04:39"
            }
          }
        },
        "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-12-27T23:04:39.929Z",
    "updatedAt": "2025-12-27T23:04:39.929Z",
    "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

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Body

application/json

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

/alert-actions

HTTPcURLJavaScriptPython

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": "23:04:39",
            "end": "23:04:39"
          },
          "TUESDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "WEDNESDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "THURSDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "FRIDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "SATURDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "SUNDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          }
        }
      },
      "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-12-27T23:04:39.929Z",
  "updatedAt": "2025-12-27T23:04:39.929Z",
  "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": "23:04:39",
            "end": "23:04:39"
          },
          "TUESDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "WEDNESDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "THURSDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "FRIDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "SATURDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "SUNDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          }
        }
      },
      "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-12-27T23:04:39.929Z",
  "updatedAt": "2025-12-27T23:04:39.929Z",
  "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

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idstringRequired

entity ID

Query parameters

Responses

200

The requested alert action

application/json

get

/alert-actions/{id}

HTTPcURLJavaScriptPython

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": "23:04:39",
            "end": "23:04:39"
          },
          "TUESDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "WEDNESDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "THURSDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "FRIDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "SATURDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "SUNDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          }
        }
      },
      "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-12-27T23:04:39.929Z",
  "updatedAt": "2025-12-27T23:04:39.929Z",
  "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

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idstringRequired

entity ID

Body

application/json

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

/alert-actions/{id}

HTTPcURLJavaScriptPython

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": "23:04:39",
            "end": "23:04:39"
          },
          "TUESDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "WEDNESDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "THURSDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "FRIDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "SATURDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "SUNDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          }
        }
      },
      "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-12-27T23:04:39.929Z",
  "updatedAt": "2025-12-27T23:04:39.929Z",
  "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": "23:04:39",
            "end": "23:04:39"
          },
          "TUESDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "WEDNESDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "THURSDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "FRIDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "SATURDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          },
          "SUNDAY": {
            "start": "23:04:39",
            "end": "23:04:39"
          }
        }
      },
      "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-12-27T23:04:39.929Z",
  "updatedAt": "2025-12-27T23:04:39.929Z",
  "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

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idstringRequired

entity ID

Responses

204

Empty body delete response

delete

/alert-actions/{id}

HTTPcURLJavaScriptPython

DELETE /api/alert-actions/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

204

Empty body delete response

No content