Alert Sources

List alert sources.

get

Authorizations

AuthorizationstringRequired

The Bearer API key of your user more info.

Query parameters

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: 50Optional

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

Default: 50

Responses

200

the alert source object

application/json

idinteger · int64Optional

namestringRequired

iconUrlstringOptional

lightIconUrlstringOptional

darkIconUrlstringOptional

integrationTypestring · enumRequiredPossible values:

integrationKeystringOptional

integrationUrlstringRead-onlyOptional

autoResolutionTimeoutstring · ISO-8601Optional

alertGroupingWindowstring · ISO-8601Optional

alertCreationstring · enumOptionalDefault: ONE_ALERT_PER_EMAILPossible values:

statusstring · enumRead-onlyOptionalPossible values:

activebooleanOptionalDefault: true

alertPriorityRulestring · enumOptionalPossible values:

bidirectionalbooleanRead-onlyOptional

autoRaiseAlertsbooleanOptional

Only effective when a support hour is linked to this alert source.

scoreThresholdnumber · doubleOptional

Only used when alertCreation is set to INTELLIGENT_GROUPING.

severityintegerOptional

createdAtstringRead-onlyOptional

updatedAtstringRead-onlyOptional

get/alert-sources

GET /api/alert-sources HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

200

the alert source object

[
  {
    "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
          },
          "team": {
            "id": 1
          },
          "users": [
            {
              "id": 1,
              "firstName": "text",
              "lastName": "text"
            }
          ],
          "schedules": [
            {
              "id": 1,
              "name": "text",
              "type": "STATIC"
            }
          ],
          "teams": [
            {
              "id": 1,
              "name": "text"
            }
          ]
        }
      ],
      "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": "00:00:00",
          "end": "00:00:00"
        },
        "TUESDAY": {
          "start": "00:00:00",
          "end": "00:00:00"
        },
        "WEDNESDAY": {
          "start": "00:00:00",
          "end": "00:00:00"
        },
        "THURSDAY": {
          "start": "00:00:00",
          "end": "00:00:00"
        },
        "FRIDAY": {
          "start": "00:00:00",
          "end": "00:00:00"
        },
        "SATURDAY": {
          "start": "00:00:00",
          "end": "00:00:00"
        },
        "SUNDAY": {
          "start": "00:00:00",
          "end": "00:00:00"
        }
      },
      "exceptions": [
        {
          "name": "text",
          "start": "2026-01-01",
          "end": "2026-01-01",
          "supportStatus": "DURING"
        }
      ]
    },
    "bidirectional": true,
    "autoRaiseAlerts": true,
    "scoreThreshold": 1,
    "severity": 1,
    "services": [
      {
        "id": 1,
        "name": "text",
        "alias": "text",
        "status": "OPERATIONAL",
        "description": "text",
        "oneOpenIncidentOnly": true,
        "showUptimeHistory": true,
        "teams": [
          {
            "id": 1,
            "name": "text"
          }
        ],
        "subscribed": true,
        "uptime": {
          "rangeStart": "2026-01-01T00:00:00.000Z",
          "rangeEnd": "2026-01-01T00:00:00.000Z",
          "outages": [
            {
              "status": "OPERATIONAL",
              "from": "2026-01-01T00:00:00.000Z",
              "until": "2026-01-01T00:00:00.000Z"
            }
          ],
          "uptimePercentage": {
            "uptimePercentage": {
              "p90": 1,
              "p60": 1,
              "p30": 1
            }
          }
        },
        "incidents": [
          {
            "id": 1,
            "summary": "text",
            "status": "INVESTIGATING",
            "message": "text",
            "sendNotification": true,
            "createdAt": "2026-01-01T00:00:00.000Z",
            "updatedAt": "2026-01-01T00:00:00.000Z",
            "affectedServices": [
              {
                "impact": "OPERATIONAL",
                "service": {
                  "id": 1,
                  "name": "text",
                  "alias": "text",
                  "status": "OPERATIONAL",
                  "description": "text",
                  "oneOpenIncidentOnly": true,
                  "showUptimeHistory": true,
                  "teams": [
                    {
                      "id": 1,
                      "name": "text"
                    }
                  ]
                }
              }
            ],
            "resolvedOn": "2026-01-01T00:00:00.000Z"
          }
        ]
      }
    ],
    "createdAt": "text",
    "updatedAt": "text"
  }
]

Create a new alert source.

post

Authorizations

AuthorizationstringRequired

The Bearer API key of your user more info.

Body

idinteger · int64Optional

namestringRequired

iconUrlstringOptional

lightIconUrlstringOptional

darkIconUrlstringOptional

integrationTypestring · enumRequiredPossible values:

integrationKeystringOptional

integrationUrlstringRead-onlyOptional

autoResolutionTimeoutstring · ISO-8601Optional

alertGroupingWindowstring · ISO-8601Optional

alertCreationstring · enumOptionalDefault: ONE_ALERT_PER_EMAILPossible values:

statusstring · enumRead-onlyOptionalPossible values:

activebooleanOptionalDefault: true

alertPriorityRulestring · enumOptionalPossible values:

bidirectionalbooleanRead-onlyOptional

eventFilterstringOptional

Defines an optional event 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

eventTypeFilterCreatestringOptional

Defines an optional create alert rule 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

eventTypeFilterAcceptstringOptional

Defines an optional accept alert rule 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

eventTypeFilterResolvestringOptional

Defines an optional resolve alert rule 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

autoRaiseAlertsbooleanOptional

Only effective when a support hour is linked to this alert source.

scoreThresholdnumber · doubleOptional

Only used when alertCreation is set to INTELLIGENT_GROUPING.

severityintegerOptional

setupStatusstring · enumOptionalPossible values:

autoCreateServicesbooleanOptionalDefault: false

createdAtstringRead-onlyOptional

updatedAtstringRead-onlyOptional

Responses

201

The URI of the alert source will be included in the location header and the alert source will be included in the body.

application/json

idinteger · int64Optional

namestringRequired

iconUrlstringOptional

lightIconUrlstringOptional

darkIconUrlstringOptional

integrationTypestring · enumRequiredPossible values:

integrationKeystringOptional

integrationUrlstringRead-onlyOptional

autoResolutionTimeoutstring · ISO-8601Optional

alertGroupingWindowstring · ISO-8601Optional

alertCreationstring · enumOptionalDefault: ONE_ALERT_PER_EMAILPossible values:

statusstring · enumRead-onlyOptionalPossible values:

activebooleanOptionalDefault: true

alertPriorityRulestring · enumOptionalPossible values:

bidirectionalbooleanRead-onlyOptional

eventFilterstringOptional

Defines an optional event 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

eventTypeFilterCreatestringOptional

Defines an optional create alert rule 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

eventTypeFilterAcceptstringOptional

Defines an optional accept alert rule 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

eventTypeFilterResolvestringOptional

Defines an optional resolve alert rule 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

autoRaiseAlertsbooleanOptional

Only effective when a support hour is linked to this alert source.

scoreThresholdnumber · doubleOptional

Only used when alertCreation is set to INTELLIGENT_GROUPING.

severityintegerOptional

setupStatusstring · enumOptionalPossible values:

autoCreateServicesbooleanOptionalDefault: false

createdAtstringRead-onlyOptional

updatedAtstringRead-onlyOptional

post/alert-sources

POST /api/alert-sources HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2517

{
  "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
        },
        "team": {
          "id": 1
        },
        "users": [
          {
            "id": 1,
            "firstName": "text",
            "lastName": "text"
          }
        ],
        "schedules": [
          {
            "id": 1,
            "name": "text",
            "type": "STATIC"
          }
        ],
        "teams": [
          {
            "id": 1,
            "name": "text"
          }
        ]
      }
    ],
    "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
  },
  "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"
      }
    ]
  },
  "severityTemplate": {
    "valueTemplate": {
      "textTemplate": "text",
      "elements": [
        {
          "type": "TEXT",
          "val": "text",
          "func": "text",
          "args": [
            {
              "S": "text",
              "N": 1
            }
          ]
        }
      ]
    },
    "mappings": [
      {
        "value": "text",
        "severity": 1
      }
    ]
  },
  "eventFilter": "text",
  "alertKeyTemplate": {
    "textTemplate": "text",
    "elements": [
      {
        "type": "TEXT",
        "val": "text",
        "func": "text",
        "args": [
          {
            "S": "text",
            "N": 1
          }
        ]
      }
    ]
  },
  "servicesTemplate": [
    {
      "textTemplate": "text",
      "elements": [
        {
          "type": "TEXT",
          "val": "text",
          "func": "text",
          "args": [
            {
              "S": "text",
              "N": 1
            }
          ]
        }
      ]
    }
  ],
  "eventTypeFilterCreate": "text",
  "eventTypeFilterAccept": "text",
  "eventTypeFilterResolve": "text",
  "autoRaiseAlerts": true,
  "scoreThreshold": 1,
  "severity": 1,
  "services": [
    {
      "id": 1,
      "name": "text",
      "alias": "text",
      "status": "OPERATIONAL",
      "description": "text",
      "oneOpenIncidentOnly": true,
      "showUptimeHistory": true,
      "teams": [
        {
          "id": 1,
          "name": "text"
        }
      ],
      "uptime": {
        "rangeStart": "2026-01-01T00:00:00.000Z",
        "rangeEnd": "2026-01-01T00:00:00.000Z",
        "outages": [
          {
            "status": "OPERATIONAL",
            "from": "2026-01-01T00:00:00.000Z",
            "until": "2026-01-01T00:00:00.000Z"
          }
        ],
        "uptimePercentage": {
          "uptimePercentage": {}
        }
      }
    }
  ],
  "setupStatus": "CREATED",
  "autoCreateServices": false
}

201

The URI of the alert source will be included in the location header and the alert source will be included in the body.

{
  "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
        },
        "team": {
          "id": 1
        },
        "users": [
          {
            "id": 1,
            "firstName": "text",
            "lastName": "text"
          }
        ],
        "schedules": [
          {
            "id": 1,
            "name": "text",
            "type": "STATIC"
          }
        ],
        "teams": [
          {
            "id": 1,
            "name": "text"
          }
        ]
      }
    ],
    "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": "00:00:00",
        "end": "00:00:00"
      },
      "TUESDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      },
      "WEDNESDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      },
      "THURSDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      },
      "FRIDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      },
      "SATURDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      },
      "SUNDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      }
    },
    "exceptions": [
      {
        "name": "text",
        "start": "2026-01-01",
        "end": "2026-01-01",
        "supportStatus": "DURING"
      }
    ]
  },
  "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"
      }
    ]
  },
  "severityTemplate": {
    "valueTemplate": {
      "textTemplate": "text",
      "elements": [
        {
          "type": "TEXT",
          "val": "text",
          "func": "text",
          "args": [
            {
              "S": "text",
              "N": 1
            }
          ]
        }
      ]
    },
    "mappings": [
      {
        "value": "text",
        "severity": 1
      }
    ]
  },
  "eventFilter": "text",
  "alertKeyTemplate": {
    "textTemplate": "text",
    "elements": [
      {
        "type": "TEXT",
        "val": "text",
        "func": "text",
        "args": [
          {
            "S": "text",
            "N": 1
          }
        ]
      }
    ]
  },
  "servicesTemplate": [
    {
      "textTemplate": "text",
      "elements": [
        {
          "type": "TEXT",
          "val": "text",
          "func": "text",
          "args": [
            {
              "S": "text",
              "N": 1
            }
          ]
        }
      ]
    }
  ],
  "eventTypeFilterCreate": "text",
  "eventTypeFilterAccept": "text",
  "eventTypeFilterResolve": "text",
  "autoRaiseAlerts": true,
  "scoreThreshold": 1,
  "severity": 1,
  "services": [
    {
      "id": 1,
      "name": "text",
      "alias": "text",
      "status": "OPERATIONAL",
      "description": "text",
      "oneOpenIncidentOnly": true,
      "showUptimeHistory": true,
      "teams": [
        {
          "id": 1,
          "name": "text"
        }
      ],
      "subscribed": true,
      "uptime": {
        "rangeStart": "2026-01-01T00:00:00.000Z",
        "rangeEnd": "2026-01-01T00:00:00.000Z",
        "outages": [
          {
            "status": "OPERATIONAL",
            "from": "2026-01-01T00:00:00.000Z",
            "until": "2026-01-01T00:00:00.000Z"
          }
        ],
        "uptimePercentage": {
          "uptimePercentage": {
            "p90": 1,
            "p60": 1,
            "p30": 1
          }
        }
      },
      "incidents": [
        {
          "id": 1,
          "summary": "text",
          "status": "INVESTIGATING",
          "message": "text",
          "sendNotification": true,
          "createdAt": "2026-01-01T00:00:00.000Z",
          "updatedAt": "2026-01-01T00:00:00.000Z",
          "affectedServices": [
            {
              "impact": "OPERATIONAL",
              "service": {
                "id": 1,
                "name": "text",
                "alias": "text",
                "status": "OPERATIONAL",
                "description": "text",
                "oneOpenIncidentOnly": true,
                "showUptimeHistory": true,
                "teams": [
                  {
                    "id": 1,
                    "name": "text"
                  }
                ]
              }
            }
          ],
          "resolvedOn": "2026-01-01T00:00:00.000Z"
        }
      ]
    }
  ],
  "setupStatus": "CREATED",
  "autoCreateServices": false,
  "createdAt": "text",
  "updatedAt": "text"
}

Get the alert source with specified id or alternatively integration key.

get

Authorizations

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idstringRequired

numeric source id or integration key

Query parameters

Responses

200

the alert source object

application/json

idinteger · int64Optional

namestringRequired

iconUrlstringOptional

lightIconUrlstringOptional

darkIconUrlstringOptional

integrationTypestring · enumRequiredPossible values:

integrationKeystringOptional

integrationUrlstringRead-onlyOptional

autoResolutionTimeoutstring · ISO-8601Optional

alertGroupingWindowstring · ISO-8601Optional

alertCreationstring · enumOptionalDefault: ONE_ALERT_PER_EMAILPossible values:

statusstring · enumRead-onlyOptionalPossible values:

activebooleanOptionalDefault: true

alertPriorityRulestring · enumOptionalPossible values:

bidirectionalbooleanRead-onlyOptional

eventFilterstringOptional

Defines an optional event 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

eventTypeFilterCreatestringOptional

Defines an optional create alert rule 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

eventTypeFilterAcceptstringOptional

Defines an optional accept alert rule 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

eventTypeFilterResolvestringOptional

Defines an optional resolve alert rule 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

autoRaiseAlertsbooleanOptional

Only effective when a support hour is linked to this alert source.

scoreThresholdnumber · doubleOptional

Only used when alertCreation is set to INTELLIGENT_GROUPING.

severityintegerOptional

setupStatusstring · enumOptionalPossible values:

autoCreateServicesbooleanOptionalDefault: false

createdAtstringRead-onlyOptional

updatedAtstringRead-onlyOptional

get/alert-sources/{id}

GET /api/alert-sources/{id} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

200

the alert source object

{
  "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
        },
        "team": {
          "id": 1
        },
        "users": [
          {
            "id": 1,
            "firstName": "text",
            "lastName": "text"
          }
        ],
        "schedules": [
          {
            "id": 1,
            "name": "text",
            "type": "STATIC"
          }
        ],
        "teams": [
          {
            "id": 1,
            "name": "text"
          }
        ]
      }
    ],
    "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": "00:00:00",
        "end": "00:00:00"
      },
      "TUESDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      },
      "WEDNESDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      },
      "THURSDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      },
      "FRIDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      },
      "SATURDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      },
      "SUNDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      }
    },
    "exceptions": [
      {
        "name": "text",
        "start": "2026-01-01",
        "end": "2026-01-01",
        "supportStatus": "DURING"
      }
    ]
  },
  "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"
      }
    ]
  },
  "severityTemplate": {
    "valueTemplate": {
      "textTemplate": "text",
      "elements": [
        {
          "type": "TEXT",
          "val": "text",
          "func": "text",
          "args": [
            {
              "S": "text",
              "N": 1
            }
          ]
        }
      ]
    },
    "mappings": [
      {
        "value": "text",
        "severity": 1
      }
    ]
  },
  "eventFilter": "text",
  "alertKeyTemplate": {
    "textTemplate": "text",
    "elements": [
      {
        "type": "TEXT",
        "val": "text",
        "func": "text",
        "args": [
          {
            "S": "text",
            "N": 1
          }
        ]
      }
    ]
  },
  "servicesTemplate": [
    {
      "textTemplate": "text",
      "elements": [
        {
          "type": "TEXT",
          "val": "text",
          "func": "text",
          "args": [
            {
              "S": "text",
              "N": 1
            }
          ]
        }
      ]
    }
  ],
  "eventTypeFilterCreate": "text",
  "eventTypeFilterAccept": "text",
  "eventTypeFilterResolve": "text",
  "autoRaiseAlerts": true,
  "scoreThreshold": 1,
  "severity": 1,
  "services": [
    {
      "id": 1,
      "name": "text",
      "alias": "text",
      "status": "OPERATIONAL",
      "description": "text",
      "oneOpenIncidentOnly": true,
      "showUptimeHistory": true,
      "teams": [
        {
          "id": 1,
          "name": "text"
        }
      ],
      "subscribed": true,
      "uptime": {
        "rangeStart": "2026-01-01T00:00:00.000Z",
        "rangeEnd": "2026-01-01T00:00:00.000Z",
        "outages": [
          {
            "status": "OPERATIONAL",
            "from": "2026-01-01T00:00:00.000Z",
            "until": "2026-01-01T00:00:00.000Z"
          }
        ],
        "uptimePercentage": {
          "uptimePercentage": {
            "p90": 1,
            "p60": 1,
            "p30": 1
          }
        }
      },
      "incidents": [
        {
          "id": 1,
          "summary": "text",
          "status": "INVESTIGATING",
          "message": "text",
          "sendNotification": true,
          "createdAt": "2026-01-01T00:00:00.000Z",
          "updatedAt": "2026-01-01T00:00:00.000Z",
          "affectedServices": [
            {
              "impact": "OPERATIONAL",
              "service": {
                "id": 1,
                "name": "text",
                "alias": "text",
                "status": "OPERATIONAL",
                "description": "text",
                "oneOpenIncidentOnly": true,
                "showUptimeHistory": true,
                "teams": [
                  {
                    "id": 1,
                    "name": "text"
                  }
                ]
              }
            }
          ],
          "resolvedOn": "2026-01-01T00:00:00.000Z"
        }
      ]
    }
  ],
  "setupStatus": "CREATED",
  "autoCreateServices": false,
  "createdAt": "text",
  "updatedAt": "text"
}

Update an existing alert source.

put

Authorizations

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idnumberRequired

entity ID

Body

idinteger · int64Optional

namestringRequired

iconUrlstringOptional

lightIconUrlstringOptional

darkIconUrlstringOptional

integrationTypestring · enumRequiredPossible values:

integrationKeystringOptional

integrationUrlstringRead-onlyOptional

autoResolutionTimeoutstring · ISO-8601Optional

alertGroupingWindowstring · ISO-8601Optional

alertCreationstring · enumOptionalDefault: ONE_ALERT_PER_EMAILPossible values:

statusstring · enumRead-onlyOptionalPossible values:

activebooleanOptionalDefault: true

alertPriorityRulestring · enumOptionalPossible values:

bidirectionalbooleanRead-onlyOptional

eventFilterstringOptional

Defines an optional event 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

eventTypeFilterCreatestringOptional

Defines an optional create alert rule 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

eventTypeFilterAcceptstringOptional

Defines an optional accept alert rule 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

eventTypeFilterResolvestringOptional

Defines an optional resolve alert rule 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

autoRaiseAlertsbooleanOptional

Only effective when a support hour is linked to this alert source.

scoreThresholdnumber · doubleOptional

Only used when alertCreation is set to INTELLIGENT_GROUPING.

severityintegerOptional

setupStatusstring · enumOptionalPossible values:

autoCreateServicesbooleanOptionalDefault: false

createdAtstringRead-onlyOptional

updatedAtstringRead-onlyOptional

Responses

200

the updated alert source object

application/json

idinteger · int64Optional

namestringRequired

iconUrlstringOptional

lightIconUrlstringOptional

darkIconUrlstringOptional

integrationTypestring · enumRequiredPossible values:

integrationKeystringOptional

integrationUrlstringRead-onlyOptional

autoResolutionTimeoutstring · ISO-8601Optional

alertGroupingWindowstring · ISO-8601Optional

alertCreationstring · enumOptionalDefault: ONE_ALERT_PER_EMAILPossible values:

statusstring · enumRead-onlyOptionalPossible values:

activebooleanOptionalDefault: true

alertPriorityRulestring · enumOptionalPossible values:

bidirectionalbooleanRead-onlyOptional

eventFilterstringOptional

Defines an optional event 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

eventTypeFilterCreatestringOptional

Defines an optional create alert rule 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

eventTypeFilterAcceptstringOptional

Defines an optional accept alert rule 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

eventTypeFilterResolvestringOptional

Defines an optional resolve alert rule 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. It has no effect on manually created alerts. Note: this field is an ?include, it will not appear in lists.

autoRaiseAlertsbooleanOptional

Only effective when a support hour is linked to this alert source.

scoreThresholdnumber · doubleOptional

Only used when alertCreation is set to INTELLIGENT_GROUPING.

severityintegerOptional

setupStatusstring · enumOptionalPossible values:

autoCreateServicesbooleanOptionalDefault: false

createdAtstringRead-onlyOptional

updatedAtstringRead-onlyOptional

put/alert-sources/{id}

PUT /api/alert-sources/{id} HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2517

{
  "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
        },
        "team": {
          "id": 1
        },
        "users": [
          {
            "id": 1,
            "firstName": "text",
            "lastName": "text"
          }
        ],
        "schedules": [
          {
            "id": 1,
            "name": "text",
            "type": "STATIC"
          }
        ],
        "teams": [
          {
            "id": 1,
            "name": "text"
          }
        ]
      }
    ],
    "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
  },
  "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"
      }
    ]
  },
  "severityTemplate": {
    "valueTemplate": {
      "textTemplate": "text",
      "elements": [
        {
          "type": "TEXT",
          "val": "text",
          "func": "text",
          "args": [
            {
              "S": "text",
              "N": 1
            }
          ]
        }
      ]
    },
    "mappings": [
      {
        "value": "text",
        "severity": 1
      }
    ]
  },
  "eventFilter": "text",
  "alertKeyTemplate": {
    "textTemplate": "text",
    "elements": [
      {
        "type": "TEXT",
        "val": "text",
        "func": "text",
        "args": [
          {
            "S": "text",
            "N": 1
          }
        ]
      }
    ]
  },
  "servicesTemplate": [
    {
      "textTemplate": "text",
      "elements": [
        {
          "type": "TEXT",
          "val": "text",
          "func": "text",
          "args": [
            {
              "S": "text",
              "N": 1
            }
          ]
        }
      ]
    }
  ],
  "eventTypeFilterCreate": "text",
  "eventTypeFilterAccept": "text",
  "eventTypeFilterResolve": "text",
  "autoRaiseAlerts": true,
  "scoreThreshold": 1,
  "severity": 1,
  "services": [
    {
      "id": 1,
      "name": "text",
      "alias": "text",
      "status": "OPERATIONAL",
      "description": "text",
      "oneOpenIncidentOnly": true,
      "showUptimeHistory": true,
      "teams": [
        {
          "id": 1,
          "name": "text"
        }
      ],
      "uptime": {
        "rangeStart": "2026-01-01T00:00:00.000Z",
        "rangeEnd": "2026-01-01T00:00:00.000Z",
        "outages": [
          {
            "status": "OPERATIONAL",
            "from": "2026-01-01T00:00:00.000Z",
            "until": "2026-01-01T00:00:00.000Z"
          }
        ],
        "uptimePercentage": {
          "uptimePercentage": {}
        }
      }
    }
  ],
  "setupStatus": "CREATED",
  "autoCreateServices": false
}

200

the updated alert source object

{
  "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
        },
        "team": {
          "id": 1
        },
        "users": [
          {
            "id": 1,
            "firstName": "text",
            "lastName": "text"
          }
        ],
        "schedules": [
          {
            "id": 1,
            "name": "text",
            "type": "STATIC"
          }
        ],
        "teams": [
          {
            "id": 1,
            "name": "text"
          }
        ]
      }
    ],
    "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": "00:00:00",
        "end": "00:00:00"
      },
      "TUESDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      },
      "WEDNESDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      },
      "THURSDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      },
      "FRIDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      },
      "SATURDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      },
      "SUNDAY": {
        "start": "00:00:00",
        "end": "00:00:00"
      }
    },
    "exceptions": [
      {
        "name": "text",
        "start": "2026-01-01",
        "end": "2026-01-01",
        "supportStatus": "DURING"
      }
    ]
  },
  "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"
      }
    ]
  },
  "severityTemplate": {
    "valueTemplate": {
      "textTemplate": "text",
      "elements": [
        {
          "type": "TEXT",
          "val": "text",
          "func": "text",
          "args": [
            {
              "S": "text",
              "N": 1
            }
          ]
        }
      ]
    },
    "mappings": [
      {
        "value": "text",
        "severity": 1
      }
    ]
  },
  "eventFilter": "text",
  "alertKeyTemplate": {
    "textTemplate": "text",
    "elements": [
      {
        "type": "TEXT",
        "val": "text",
        "func": "text",
        "args": [
          {
            "S": "text",
            "N": 1
          }
        ]
      }
    ]
  },
  "servicesTemplate": [
    {
      "textTemplate": "text",
      "elements": [
        {
          "type": "TEXT",
          "val": "text",
          "func": "text",
          "args": [
            {
              "S": "text",
              "N": 1
            }
          ]
        }
      ]
    }
  ],
  "eventTypeFilterCreate": "text",
  "eventTypeFilterAccept": "text",
  "eventTypeFilterResolve": "text",
  "autoRaiseAlerts": true,
  "scoreThreshold": 1,
  "severity": 1,
  "services": [
    {
      "id": 1,
      "name": "text",
      "alias": "text",
      "status": "OPERATIONAL",
      "description": "text",
      "oneOpenIncidentOnly": true,
      "showUptimeHistory": true,
      "teams": [
        {
          "id": 1,
          "name": "text"
        }
      ],
      "subscribed": true,
      "uptime": {
        "rangeStart": "2026-01-01T00:00:00.000Z",
        "rangeEnd": "2026-01-01T00:00:00.000Z",
        "outages": [
          {
            "status": "OPERATIONAL",
            "from": "2026-01-01T00:00:00.000Z",
            "until": "2026-01-01T00:00:00.000Z"
          }
        ],
        "uptimePercentage": {
          "uptimePercentage": {
            "p90": 1,
            "p60": 1,
            "p30": 1
          }
        }
      },
      "incidents": [
        {
          "id": 1,
          "summary": "text",
          "status": "INVESTIGATING",
          "message": "text",
          "sendNotification": true,
          "createdAt": "2026-01-01T00:00:00.000Z",
          "updatedAt": "2026-01-01T00:00:00.000Z",
          "affectedServices": [
            {
              "impact": "OPERATIONAL",
              "service": {
                "id": 1,
                "name": "text",
                "alias": "text",
                "status": "OPERATIONAL",
                "description": "text",
                "oneOpenIncidentOnly": true,
                "showUptimeHistory": true,
                "teams": [
                  {
                    "id": 1,
                    "name": "text"
                  }
                ]
              }
            }
          ],
          "resolvedOn": "2026-01-01T00:00:00.000Z"
        }
      ]
    }
  ],
  "setupStatus": "CREATED",
  "autoCreateServices": false,
  "createdAt": "text",
  "updatedAt": "text"
}

Delete the specified alert source.

delete

Authorizations

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idnumberRequired

entity ID

Responses

204

if deletion was successful

delete/alert-sources/{id}

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

204

if deletion was successful

No content