# Alert Actions

## GET /alerts/{id}/actions

> Get available actions for specified alert.

```json
{"openapi":"3.0.1","info":{"title":"ilert REST API","version":"v2.2026.5-r.3"},"tags":[{"name":"Alert Actions"}],"servers":[{"url":"/api"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","description":"The Bearer API key of your user <a href='/api-docs/#section/Authentication'>more info</a>.","name":"Authorization","in":"header"}},"schemas":{"AlertActionTrigger":{"type":"object","properties":{"alertActionId":{"type":"string"},"connectorId":{"type":"string"},"type":{"type":"string"},"name":{"type":"string"},"iconUrl":{"type":"string"},"history":{"type":"array","items":{"$ref":"#/components/schemas/AlertActionResult"}}}},"AlertActionResult":{"type":"object","properties":{"id":{"type":"string"},"alertActionId":{"type":"string"},"connectorId":{"type":"string"},"alertId":{"type":"number"},"success":{"type":"boolean"},"actor":{"$ref":"#/components/schemas/User"}}},"User":{"required":["email","firstName","lastName"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"firstName":{"type":"string"},"lastName":{"type":"string"},"email":{"type":"string"},"timezone":{"$ref":"#/components/schemas/TimeZone"},"position":{"type":"string"},"department":{"type":"string"},"avatarUrl":{"type":"string","readOnly":true},"language":{"type":"string","enum":["de","en"]},"region":{"type":"string","enum":["DE","GB","CH","CN","IN","US","FR","ES","CA","IE"]},"role":{"$ref":"#/components/schemas/Role"},"shiftColor":{"type":"string","description":"Optional hex-color code for the user's shifts in schedules calendars"},"mutedUntil":{"type":"string","description":"Date in ISO-8601","format":"date-time"},"createdAt":{"type":"string","description":"Date in ISO-8601","format":"date-time"},"updatedAt":{"type":"string","description":"Date in ISO-8601","format":"date-time"}}},"TimeZone":{"type":"string","enum":["Europe/Berlin","America/New_York","America/Los_Angeles","Asia/Istanbul"]},"Role":{"type":"string","enum":["STAKEHOLDER","GUEST","RESPONDER","USER","ADMIN"]}}},"paths":{"/alerts/{id}/actions":{"get":{"tags":["Alert Actions"],"summary":"Get available actions for specified alert.","parameters":[{"name":"id","in":"path","description":"entity ID","required":true,"schema":{"type":"number"}}],"responses":{"200":{"description":"list of alert actions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertActionTrigger"}}}}}}}}}
```

## POST /alerts/{id}/actions

> Invoke a specific alert action.

```json
{"openapi":"3.0.1","info":{"title":"ilert REST API","version":"v2.2026.5-r.3"},"tags":[{"name":"Alert Actions"}],"servers":[{"url":"/api"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","description":"The Bearer API key of your user <a href='/api-docs/#section/Authentication'>more info</a>.","name":"Authorization","in":"header"}},"schemas":{"AlertActionTrigger":{"type":"object","properties":{"alertActionId":{"type":"string"},"connectorId":{"type":"string"},"type":{"type":"string"},"name":{"type":"string"},"iconUrl":{"type":"string"},"history":{"type":"array","items":{"$ref":"#/components/schemas/AlertActionResult"}}}},"AlertActionResult":{"type":"object","properties":{"id":{"type":"string"},"alertActionId":{"type":"string"},"connectorId":{"type":"string"},"alertId":{"type":"number"},"success":{"type":"boolean"},"actor":{"$ref":"#/components/schemas/User"}}},"User":{"required":["email","firstName","lastName"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"firstName":{"type":"string"},"lastName":{"type":"string"},"email":{"type":"string"},"timezone":{"$ref":"#/components/schemas/TimeZone"},"position":{"type":"string"},"department":{"type":"string"},"avatarUrl":{"type":"string","readOnly":true},"language":{"type":"string","enum":["de","en"]},"region":{"type":"string","enum":["DE","GB","CH","CN","IN","US","FR","ES","CA","IE"]},"role":{"$ref":"#/components/schemas/Role"},"shiftColor":{"type":"string","description":"Optional hex-color code for the user's shifts in schedules calendars"},"mutedUntil":{"type":"string","description":"Date in ISO-8601","format":"date-time"},"createdAt":{"type":"string","description":"Date in ISO-8601","format":"date-time"},"updatedAt":{"type":"string","description":"Date in ISO-8601","format":"date-time"}}},"TimeZone":{"type":"string","enum":["Europe/Berlin","America/New_York","America/Los_Angeles","Asia/Istanbul"]},"Role":{"type":"string","enum":["STAKEHOLDER","GUEST","RESPONDER","USER","ADMIN"]}}},"paths":{"/alerts/{id}/actions":{"post":{"tags":["Alert Actions"],"summary":"Invoke a specific alert action.","parameters":[{"name":"id","in":"path","description":"entity ID","required":true,"schema":{"type":"number"}}],"requestBody":{"description":"the alert action, you might skip the 'history' field","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertActionTrigger"}}},"required":true},"responses":{"201":{"description":"the alert action result, validate the 'success' field","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertActionResult"}}}}}}}}}
```

## GET /alert-actions

> Get alert actions.

```json
{"openapi":"3.0.1","info":{"title":"ilert REST API","version":"v2.2026.5-r.3"},"tags":[{"name":"Alert Actions"}],"servers":[{"url":"/api"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","description":"The Bearer API key of your user <a href='/api-docs/#section/Authentication'>more info</a>.","name":"Authorization","in":"header"}},"schemas":{"AlertAction":{"required":["connectorType","name"],"type":"object","properties":{"id":{"type":"string"},"alertSources":{"type":"array","items":{"$ref":"#/components/schemas/AlertSource"}},"connectorId":{"type":"string"},"connectorType":{"$ref":"#/components/schemas/AlertActionType"},"name":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"triggerMode":{"type":"string","enum":["AUTOMATIC","MANUAL"]},"bidirectional":{"type":"boolean","readOnly":true},"escalationEndedDelaySec":{"maximum":7200,"minimum":0,"type":"number","description":"May only be used with triggerType 'alert-escalation-ended' selected"},"notResolvedDelaySec":{"maximum":7200,"minimum":0,"type":"number","description":"May only be used with triggerType 'v-alert-not-resolved' selected"},"triggerTypes":{"type":"array","items":{"type":"string","enum":["alert-created","alert-assigned","alert-auto-escalated","alert-acknowledged","alert-raised","alert-comment-added","alert-escalation-ended","alert-resolved","alert-responder-added","alert-responder-removed","alert-channel-attached","alert-channel-detached","v-alert-not-resolved"]}},"alertFilter":{"type":"object","description":"This field is deprecated, use 'conditions' instead. If both are used this field is ignored.","properties":{"operator":{"type":"string","enum":["AND","OR"]},"predicates":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","enum":["ALERT_SUMMARY","ALERT_DETAILS","ESCALATION_POLICY","ALERT_PRIORITY"]},"criteria":{"type":"string","enum":["CONTAINS_ANY_WORDS","CONTAINS_NOT_WORDS","CONTAINS_STRING","CONTAINS_NOT_STRING","IS_STRING","IS_NOT_STRING","MATCHES_REGEX","MATCHES_NOT_REGEX"]},"value":{"type":"string"}}}}}},"conditions":{"type":"string","description":"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."},"params":{"type":"object","oneOf":[{"$ref":"#/components/schemas/CParamsDatadog"},{"$ref":"#/components/schemas/CParamsJira"},{"$ref":"#/components/schemas/CParamsMicrosoftTeams"},{"$ref":"#/components/schemas/CParamsMicrosoftTeamsWebhookOnly"},{"$ref":"#/components/schemas/CParamsServiceNow"},{"$ref":"#/components/schemas/CParamsAutotask"},{"$ref":"#/components/schemas/CParamsSlack"},{"$ref":"#/components/schemas/CParamsWebhook"},{"$ref":"#/components/schemas/CParamsZendesk"},{"$ref":"#/components/schemas/CParamsDiscord"},{"$ref":"#/components/schemas/CParamsGithub"},{"$ref":"#/components/schemas/CParamsTopdesk"},{"$ref":"#/components/schemas/CParamsAWSLambda"},{"$ref":"#/components/schemas/CParamsAzureFunction"},{"$ref":"#/components/schemas/CParamsGoogleFunction"},{"$ref":"#/components/schemas/CParamsEmail"},{"$ref":"#/components/schemas/CParamsSysdig"},{"$ref":"#/components/schemas/CParamsZapier"},{"$ref":"#/components/schemas/CParamsZoomChat"},{"$ref":"#/components/schemas/CParamsZoomMeeting"},{"$ref":"#/components/schemas/CParamsStatusPageIO"},{"$ref":"#/components/schemas/CParamsDingTalk"},{"$ref":"#/components/schemas/CParamsDingTalkAction"},{"$ref":"#/components/schemas/CParamsAutomationRule"},{"$ref":"#/components/schemas/CParamsAutomationRule"},{"$ref":"#/components/schemas/CParamsTelegram"},{"$ref":"#/components/schemas/CParamsGoogleChat"},{"$ref":"#/components/schemas/CParamsGoogleChatWebhookOnly"}]},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}}}},"AlertSource":{"required":["escalationPolicy","integrationType","name"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}},"name":{"type":"string"},"iconUrl":{"type":"string"},"lightIconUrl":{"type":"string"},"darkIconUrl":{"type":"string"},"escalationPolicy":{"$ref":"#/components/schemas/EscalationPolicy"},"integrationType":{"$ref":"#/components/schemas/IntegrationType"},"integrationKey":{"type":"string"},"integrationUrl":{"type":"string","readOnly":true},"autoResolutionTimeout":{"type":"string","format":"ISO-8601"},"alertGroupingWindow":{"type":"string","format":"ISO-8601"},"alertCreation":{"type":"string","default":"ONE_ALERT_PER_EMAIL","enum":["ONE_ALERT_PER_EMAIL","ONE_ALERT_PER_EMAIL_SUBJECT","ONE_PENDING_ALERT_ALLOWED","ONE_OPEN_ALERT_ALLOWED","OPEN_RESOLVE_ON_EXTRACTION","ONE_ALERT_GROUPED_PER_WINDOW","INTELLIGENT_GROUPING"]},"status":{"type":"string","readOnly":true,"enum":["PENDING","ALL_ACCEPTED","ALL_RESOLVED","IN_MAINTENANCE","DISABLED"]},"active":{"type":"boolean","default":true},"alertPriorityRule":{"$ref":"#/components/schemas/AlertPriorityRule"},"supportHours":{"$ref":"#/components/schemas/SupportHour"},"bidirectional":{"type":"boolean","readOnly":true},"summaryTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"detailsTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"routingTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"linkTemplates":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourceLinkTemplate"}},"priorityTemplate":{"$ref":"#/components/schemas/AlertSourcePriorityTemplate"},"severityTemplate":{"$ref":"#/components/schemas/AlertSourceSeverityTemplate"},"eventFilter":{"type":"string","description":"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."},"alertKeyTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"servicesTemplate":{"type":"array","description":"Optional list of templates that extract service identifiers from the inbound event payload. Each rendered value is comma-split, and each resulting token is resolved against the tenant's services by alias or name (case-insensitive). Unmatched tokens are silently dropped. Capped at 10 templates and at the alert's per-event services limit. Note: this field is an ?include, it will not appear in lists.","items":{"$ref":"#/components/schemas/AlertSourceTemplate"}},"eventTypeFilterCreate":{"type":"string","description":"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."},"eventTypeFilterAccept":{"type":"string","description":"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."},"eventTypeFilterResolve":{"type":"string","description":"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."},"autoRaiseAlerts":{"type":"boolean","description":"Only effective when a support hour is linked to this alert source."},"scoreThreshold":{"type":"number","format":"double","description":"Only used when alertCreation is set to INTELLIGENT_GROUPING."},"severity":{"type":"integer"},"services":{"type":"array","items":{"$ref":"#/components/schemas/Service"}},"setupStatus":{"type":"string","enum":["CREATED","CREATED_ADVANCED","CREATED_BIDIRECTIONAL","FINISHED"]},"autoCreateServices":{"type":"boolean","default":false},"createdAt":{"type":"string","readOnly":true},"updatedAt":{"type":"string","readOnly":true}}},"TeamRel":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"}}},"EscalationPolicy":{"required":["escalationRules","name"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"escalationRules":{"type":"array","items":{"$ref":"#/components/schemas/EscalationRule"}},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}},"repeating":{"type":"boolean","default":false},"frequency":{"maximum":9,"minimum":1,"type":"integer","format":"int32","default":1},"delayMin":{"maximum":15,"minimum":0,"type":"integer","format":"int32","default":0},"routingKey":{"type":"string","description":"optional"}}},"EscalationRule":{"required":["escalationTimeout"],"type":"object","properties":{"escalationTimeout":{"type":"integer"},"user":{"type":"object","properties":{"id":{"type":"number"}},"description":"This field (type: User) is deprecated, please use 'users' instead"},"schedule":{"type":"object","properties":{"id":{"type":"number"}},"description":"This field (type: Schedule) is deprecated, please use 'schedules' instead"},"team":{"type":"object","properties":{"id":{"type":"number"}},"description":"This field (type: Team) is deprecated, please use 'teams' instead"},"users":{"type":"array","items":{"$ref":"#/components/schemas/UserRel"}},"schedules":{"type":"array","items":{"$ref":"#/components/schemas/ScheduleRel"}},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}}}},"UserRel":{"required":["id"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"firstName":{"type":"string"},"lastName":{"type":"string"}}},"ScheduleRel":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"type":{"type":"string","enum":["STATIC","RECURRING"]}}},"IntegrationType":{"type":"string","enum":["NAGIOS","ICINGA","EMAIL2","SMS","API","HEARTBEAT2","PRTG","PINGDOM","CLOUDWATCH","AWSPHD","STACKDRIVER","INSTANA","ZABBIX","SOLARWINDS","PROMETHEUS","NEWRELIC","GRAFANA","GITHUB","DATADOG","UPTIMEROBOT","APPDYNAMICS","DYNATRACE","TOPDESK","STATUSCAKE","MONITOR","TOOL","CHECKMK","AUTOTASK","AWSBUDGET","SYSDIG","SERVERDENSITY","ZAPIER","KENTIXAM","JIRA","CONSUL","ZAMMAD","SPLUNK","SERVICENOW","SEARCHGUARD","KUBERNETES","SIGNALFX","AZUREALERTS","TERRAFORMCLOUD","SENTRY","SEMATEXT","SUMOLOGIC","RAYGUN","MXTOOLBOX","ESWATCHER","AMAZONSNS","KAPACITOR","CORTEXXSOAR","ZENDESK","AUVIK","SENSU","NCENTRAL","JUMPCLOUD","SALESFORCE","GUARDDUTY","STATUSHUB","IXON","APIFORTRESS","FRESHSERVICE","APPSIGNAL","LIGHTSTEP","IBMCLOUDFUNCTIONS","CROWDSTRIKE","HUMIO","OHDEAR","MONGODBATLAS","GITLAB","HYPERPING","PAPRISMACLOUD","SAMSARA","PANDORAFMS","MSSCOM","TWILIO","CISCOMERAKI","CHECKLY","POSTHOG","GOOGLESCC","SLACK","MSTEAMS","UPTIMEKUMA","TWILIOERRORS","PARTICLE","CLOUDFLARE","TULIP","GRAYLOG","CATCHPOINT","LOKI","CORTEX","MIMIR","HALOPSA","INFLUXDB","CALLFLOW","HALOITSM","KIBANA","VICTORIAMETRICS","HONEYCOMB","FOURME","KEEP","UBIDOTS","HETRIXTOOLS","POSTMAN","CLUSTERCONTROL","NETDATA","AWX","KAFKA","MQTT","RAPIDSPIKE","HONEYBADGER","HEALTHCHECKSIO","MEZMO","SERVERGUARD24","CISCOTHOUSANDEYES","SITE24X7","ITCONDUCTOR","SAPFRUN","APICA","DASH0","ROLLBAR","GATUS","LIBRENMS","PANTHER","TEAMCITY","ALIBABACLOUD","FLEETDM","CONNECTWISEPSA","DEADMANSSNITCH","FORTISOAR","OPMANAGER","CRONITOR","DOMOTZ","LIVEWATCH","AZUREDEVOPS","LEVELIO","EKARA","SYSAID","PHAREIO","OPSGENIE","WHATAP","SIGNOZ","GOOGLECHAT","DOTCOMMONITOR","UPTIME","HELPSCOUT","SCIENCELOGIC","PULSETIC","WAZUH","SEKOIA"]},"AlertPriorityRule":{"type":"string","enum":["HIGH","LOW","HIGH_DURING_SUPPORT_HOURS","LOW_DURING_SUPPORT_HOURS"]},"SupportHour":{"required":["name","supportDays","timezone"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}},"timezone":{"$ref":"#/components/schemas/TimeZone"},"supportDays":{"type":"object","properties":{"MONDAY":{"$ref":"#/components/schemas/SupportDay"},"TUESDAY":{"$ref":"#/components/schemas/SupportDay"},"WEDNESDAY":{"$ref":"#/components/schemas/SupportDay"},"THURSDAY":{"$ref":"#/components/schemas/SupportDay"},"FRIDAY":{"$ref":"#/components/schemas/SupportDay"},"SATURDAY":{"$ref":"#/components/schemas/SupportDay"},"SUNDAY":{"$ref":"#/components/schemas/SupportDay"}}},"exceptions":{"type":"array","items":{"$ref":"#/components/schemas/SupportHourException"}}}},"TimeZone":{"type":"string","enum":["Europe/Berlin","America/New_York","America/Los_Angeles","Asia/Istanbul"]},"SupportDay":{"required":["end","start"],"type":"object","properties":{"start":{"type":"string","format":"time"},"end":{"type":"string","format":"time"}}},"SupportHourException":{"type":"object","required":["name","start","end","supportStatus"],"properties":{"name":{"type":"string"},"start":{"type":"string","format":"date"},"end":{"type":"string","format":"date"},"supportStatus":{"type":"string","enum":["DURING","OUTSIDE"]}}},"AlertSourceTemplate":{"type":"object","properties":{"textTemplate":{"type":"string","description":"For more information on alert source templating, please visit: https://docs.ilert.com/alerting/alert-sources#alert-template.\n\n Example: <br />`Hi {{ users[0].name }} there!` \n\nYou can use the text template instead of elements by adding the include `textTemplate` to your request. Any version can be used for POST or PUT requests."},"elements":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourceTemplateElement"}}}},"AlertSourceTemplateElement":{"type":"object","properties":{"type":{"type":"string","enum":["TEXT","VAR","RAW"]},"val":{"type":"string"},"func":{"type":"string"},"args":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourceTemplateElementArg"}}}},"AlertSourceTemplateElementArg":{"type":"object","properties":{"S":{"type":"string"},"N":{"type":"integer"}}},"AlertSourceLinkTemplate":{"required":["hrefTemplate","text"],"type":"object","properties":{"text":{"type":"string"},"hrefTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"}}},"AlertSourcePriorityTemplate":{"required":["mappings","valueTemplate"],"type":"object","properties":{"valueTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"mappings":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourcePriorityTemplateMapping"}}}},"AlertSourcePriorityTemplateMapping":{"required":["priority","value"],"type":"object","properties":{"value":{"type":"string"},"priority":{"type":"string","enum":["LOW","HIGH"]}}},"AlertSourceSeverityTemplate":{"required":["mappings","valueTemplate"],"type":"object","properties":{"valueTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"mappings":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourceSeverityTemplateMapping"}}}},"AlertSourceSeverityTemplateMapping":{"required":["severity","value"],"type":"object","properties":{"value":{"type":"string"},"severity":{"type":"integer","format":"int32"}}},"Service":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"alias":{"type":"string"},"status":{"$ref":"#/components/schemas/ServiceStatus"},"description":{"type":"string"},"oneOpenIncidentOnly":{"type":"boolean"},"showUptimeHistory":{"type":"boolean"},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}},"subscribed":{"type":"boolean","readOnly":true},"uptime":{"$ref":"#/components/schemas/ServiceUptime"},"incidents":{"type":"array","description":"Note that this only contains the latest 10 unresolved incidents, use /api/incidents?service=x if more or specific results are needed","readOnly":true,"items":{"$ref":"#/components/schemas/IncidentNoIncludes"}}}},"ServiceStatus":{"type":"string","description":"the service status","enum":["OPERATIONAL","UNDER_MAINTENANCE","DEGRADED","PARTIAL_OUTAGE","MAJOR_OUTAGE"]},"ServiceUptime":{"type":"object","properties":{"rangeStart":{"type":"string","format":"date-time"},"rangeEnd":{"type":"string","format":"date-time"},"outages":{"type":"array","items":{"$ref":"#/components/schemas/ServiceOutage"}},"uptimePercentage":{"$ref":"#/components/schemas/ServiceUptimePercentage"}}},"ServiceOutage":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/ServiceStatus"},"from":{"type":"string","format":"date-time"},"until":{"type":"string","format":"date-time"}}},"ServiceUptimePercentage":{"type":"object","properties":{"uptimePercentage":{"type":"object","properties":{"p90":{"maximum":100,"minimum":0,"type":"number","format":"float","readOnly":true},"p60":{"maximum":100,"minimum":0,"type":"number","format":"float","readOnly":true},"p30":{"maximum":100,"minimum":0,"type":"number","format":"float","readOnly":true}}}}},"IncidentNoIncludes":{"type":"object","properties":{"id":{"type":"number"},"summary":{"type":"string"},"status":{"$ref":"#/components/schemas/IncidentStatus"},"message":{"type":"string"},"sendNotification":{"type":"boolean"},"createdAt":{"type":"string","description":"May be overwritten during the creation of the incident, otherwise read-only","format":"date-time"},"updatedAt":{"type":"string","description":"May be overwritten during the creation of the incident, otherwise read-only","format":"date-time"},"affectedServices":{"type":"array","items":{"type":"object","properties":{"impact":{"$ref":"#/components/schemas/ServiceStatus"},"service":{"$ref":"#/components/schemas/ServiceNoIncludes"}}}},"resolvedOn":{"type":"string","format":"date-time","readOnly":true}}},"IncidentStatus":{"type":"string","description":"the incident status","enum":["INVESTIGATING","IDENTIFIED","MONITORING","RESOLVED"]},"ServiceNoIncludes":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"alias":{"type":"string"},"status":{"$ref":"#/components/schemas/ServiceStatus"},"description":{"type":"string"},"oneOpenIncidentOnly":{"type":"boolean"},"showUptimeHistory":{"type":"boolean"},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}}}},"AlertActionType":{"type":"string","enum":["autotask","jira","microsoft_teams_bot","microsoft_teams_webhook","servicenow","slack","slack_webhook","webhook","zendesk","discord","github","topdesk","email","zapier","zammad","mattermost","zoom_chat","dingtalk","aws_event_bridge","dynamic","zabbix","automation_rule","telegram","google_chat_bot","google_chat_webhook"]},"CParamsDatadog":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"string"}},"priority":{"type":"string"},"site":{"type":"string"}}},"CParamsJira":{"type":"object","properties":{"project":{"type":"string"},"issueType":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsMicrosoftTeams":{"required":["channelId","teamId"],"type":"object","properties":{"channelId":{"type":"string"},"channelName":{"type":"string"},"teamId":{"type":"string"},"teamName":{"type":"string"},"type":{"type":"string","enum":["chat","meeting"]}}},"CParamsMicrosoftTeamsWebhookOnly":{"type":"object"},"CParamsServiceNow":{"type":"object","properties":{"callerId":{"type":"string"},"impact":{"type":"string"},"urgency":{"type":"string"},"closeCode":{"type":"string"},"assignmentGroup":{"type":"string"},"ownerGroup":{"type":"string"},"service":{"type":"string"},"serviceOffering":{"type":"string"},"contactType":{"type":"string"}}},"CParamsAutotask":{"required":["queueId"],"type":"object","properties":{"companyId":{"type":"string"},"queueId":{"type":"string"},"ticketCategory":{"type":"string"},"ticketType":{"type":"string"},"noteType":{"type":"string"},"notePublish":{"type":"string"},"status":{"type":"string"}}},"CParamsSlack":{"required":["channelId"],"type":"object","properties":{"channelId":{"type":"string"},"channelName":{"type":"string"},"teamDomain":{"type":"string"},"teamId":{"type":"string"}}},"CParamsWebhook":{"required":["webhookUrl"],"type":"object","properties":{"webhookUrl":{"type":"string"},"bodyTemplate":{"type":"string"},"headers":{"type":"array","items":{"type":"object","required":["key","value"],"properties":{"key":{"type":"string"},"value":{"type":"string"}}}}}},"CParamsZendesk":{"type":"object","properties":{"priority":{"type":"string"}}},"CParamsDiscord":{"type":"object"},"CParamsGithub":{"type":"object","properties":{"owner":{"type":"string"},"repository":{"type":"string"},"labels":{"type":"array","items":{"type":"string"}}}},"CParamsTopdesk":{"type":"object","properties":{"status":{"type":"string"}}},"CParamsAWSLambda":{"type":"object","properties":{"webhookUrl":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsAzureFunction":{"type":"object","properties":{"webhookUrl":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsGoogleFunction":{"type":"object","properties":{"webhookUrl":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsEmail":{"type":"object","properties":{"recipients":{"type":"array","items":{"type":"string"}},"subject":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsSysdig":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"string"}},"eventFilter":{"type":"string"}}},"CParamsZapier":{"type":"object","properties":{"webhookUrl":{"type":"string"}}},"CParamsZoomChat":{"type":"object","properties":{"channelId":{"type":"string"}}},"CParamsZoomMeeting":{"type":"object","properties":{"password":{"type":"string"}}},"CParamsStatusPageIO":{"type":"object","properties":{"pageId":{"type":"string"}}},"CParamsDingTalk":{"type":"object","properties":{"isAtAll":{"type":"boolean"},"atMobiles":{"type":"array","items":{"type":"string"}}}},"CParamsDingTalkAction":{"type":"object","properties":{"url":{"type":"string"},"secret":{"type":"string"},"isAtAll":{"type":"boolean"},"atMobiles":{"type":"array","items":{"type":"string"}}}},"CParamsAutomationRule":{"required":["alertType","serviceIds","serviceStatus"],"type":"object","properties":{"alertType":{"type":"string","enum":["CREATED","ACCEPTED"]},"resolveIncident":{"type":"boolean","default":false},"serviceStatus":{"$ref":"#/components/schemas/ServiceStatus"},"templateId":{"type":"integer","format":"int64"},"sendNotification":{"type":"boolean","default":false},"serviceIds":{"type":"array","items":{"type":"integer","format":"int64"}}}},"CParamsTelegram":{"required":["channelId"],"type":"object","properties":{"channelId":{"type":"string","description":"The telegram group id, usually i64, as string"}}},"CParamsGoogleChat":{"required":["channelId"],"type":"object","properties":{"channelId":{"type":"string"},"channelName":{"type":"string"}}},"CParamsGoogleChatWebhookOnly":{"type":"object"}}},"paths":{"/alert-actions":{"get":{"tags":["Alert Actions"],"summary":"Get alert actions.","parameters":[{"name":"source","in":"query","description":"alert source id","schema":{"type":"number"}},{"name":"connector","in":"query","description":"connector id","schema":{"type":"string"}},{"name":"start-index","in":"query","description":"an integer specifying the starting point (beginning with 0) when paging through a list of entities","schema":{"type":"integer","format":"int32","default":0}},{"name":"max-results","in":"query","description":"the maximum number of results when paging through a list of alert actions.","schema":{"maximum":100,"type":"integer","format":"int32","default":100}}],"responses":{"200":{"description":"The filtered alert actions","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AlertAction"}}}}}}}}}}
```

## POST /alert-actions

> Create a new alert action.

```json
{"openapi":"3.0.1","info":{"title":"ilert REST API","version":"v2.2026.5-r.3"},"tags":[{"name":"Alert Actions"}],"servers":[{"url":"/api"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","description":"The Bearer API key of your user <a href='/api-docs/#section/Authentication'>more info</a>.","name":"Authorization","in":"header"}},"schemas":{"AlertAction":{"required":["connectorType","name"],"type":"object","properties":{"id":{"type":"string"},"alertSources":{"type":"array","items":{"$ref":"#/components/schemas/AlertSource"}},"connectorId":{"type":"string"},"connectorType":{"$ref":"#/components/schemas/AlertActionType"},"name":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"triggerMode":{"type":"string","enum":["AUTOMATIC","MANUAL"]},"bidirectional":{"type":"boolean","readOnly":true},"escalationEndedDelaySec":{"maximum":7200,"minimum":0,"type":"number","description":"May only be used with triggerType 'alert-escalation-ended' selected"},"notResolvedDelaySec":{"maximum":7200,"minimum":0,"type":"number","description":"May only be used with triggerType 'v-alert-not-resolved' selected"},"triggerTypes":{"type":"array","items":{"type":"string","enum":["alert-created","alert-assigned","alert-auto-escalated","alert-acknowledged","alert-raised","alert-comment-added","alert-escalation-ended","alert-resolved","alert-responder-added","alert-responder-removed","alert-channel-attached","alert-channel-detached","v-alert-not-resolved"]}},"alertFilter":{"type":"object","description":"This field is deprecated, use 'conditions' instead. If both are used this field is ignored.","properties":{"operator":{"type":"string","enum":["AND","OR"]},"predicates":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","enum":["ALERT_SUMMARY","ALERT_DETAILS","ESCALATION_POLICY","ALERT_PRIORITY"]},"criteria":{"type":"string","enum":["CONTAINS_ANY_WORDS","CONTAINS_NOT_WORDS","CONTAINS_STRING","CONTAINS_NOT_STRING","IS_STRING","IS_NOT_STRING","MATCHES_REGEX","MATCHES_NOT_REGEX"]},"value":{"type":"string"}}}}}},"conditions":{"type":"string","description":"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."},"params":{"type":"object","oneOf":[{"$ref":"#/components/schemas/CParamsDatadog"},{"$ref":"#/components/schemas/CParamsJira"},{"$ref":"#/components/schemas/CParamsMicrosoftTeams"},{"$ref":"#/components/schemas/CParamsMicrosoftTeamsWebhookOnly"},{"$ref":"#/components/schemas/CParamsServiceNow"},{"$ref":"#/components/schemas/CParamsAutotask"},{"$ref":"#/components/schemas/CParamsSlack"},{"$ref":"#/components/schemas/CParamsWebhook"},{"$ref":"#/components/schemas/CParamsZendesk"},{"$ref":"#/components/schemas/CParamsDiscord"},{"$ref":"#/components/schemas/CParamsGithub"},{"$ref":"#/components/schemas/CParamsTopdesk"},{"$ref":"#/components/schemas/CParamsAWSLambda"},{"$ref":"#/components/schemas/CParamsAzureFunction"},{"$ref":"#/components/schemas/CParamsGoogleFunction"},{"$ref":"#/components/schemas/CParamsEmail"},{"$ref":"#/components/schemas/CParamsSysdig"},{"$ref":"#/components/schemas/CParamsZapier"},{"$ref":"#/components/schemas/CParamsZoomChat"},{"$ref":"#/components/schemas/CParamsZoomMeeting"},{"$ref":"#/components/schemas/CParamsStatusPageIO"},{"$ref":"#/components/schemas/CParamsDingTalk"},{"$ref":"#/components/schemas/CParamsDingTalkAction"},{"$ref":"#/components/schemas/CParamsAutomationRule"},{"$ref":"#/components/schemas/CParamsAutomationRule"},{"$ref":"#/components/schemas/CParamsTelegram"},{"$ref":"#/components/schemas/CParamsGoogleChat"},{"$ref":"#/components/schemas/CParamsGoogleChatWebhookOnly"}]},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}}}},"AlertSource":{"required":["escalationPolicy","integrationType","name"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}},"name":{"type":"string"},"iconUrl":{"type":"string"},"lightIconUrl":{"type":"string"},"darkIconUrl":{"type":"string"},"escalationPolicy":{"$ref":"#/components/schemas/EscalationPolicy"},"integrationType":{"$ref":"#/components/schemas/IntegrationType"},"integrationKey":{"type":"string"},"integrationUrl":{"type":"string","readOnly":true},"autoResolutionTimeout":{"type":"string","format":"ISO-8601"},"alertGroupingWindow":{"type":"string","format":"ISO-8601"},"alertCreation":{"type":"string","default":"ONE_ALERT_PER_EMAIL","enum":["ONE_ALERT_PER_EMAIL","ONE_ALERT_PER_EMAIL_SUBJECT","ONE_PENDING_ALERT_ALLOWED","ONE_OPEN_ALERT_ALLOWED","OPEN_RESOLVE_ON_EXTRACTION","ONE_ALERT_GROUPED_PER_WINDOW","INTELLIGENT_GROUPING"]},"status":{"type":"string","readOnly":true,"enum":["PENDING","ALL_ACCEPTED","ALL_RESOLVED","IN_MAINTENANCE","DISABLED"]},"active":{"type":"boolean","default":true},"alertPriorityRule":{"$ref":"#/components/schemas/AlertPriorityRule"},"supportHours":{"$ref":"#/components/schemas/SupportHour"},"bidirectional":{"type":"boolean","readOnly":true},"summaryTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"detailsTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"routingTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"linkTemplates":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourceLinkTemplate"}},"priorityTemplate":{"$ref":"#/components/schemas/AlertSourcePriorityTemplate"},"severityTemplate":{"$ref":"#/components/schemas/AlertSourceSeverityTemplate"},"eventFilter":{"type":"string","description":"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."},"alertKeyTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"servicesTemplate":{"type":"array","description":"Optional list of templates that extract service identifiers from the inbound event payload. Each rendered value is comma-split, and each resulting token is resolved against the tenant's services by alias or name (case-insensitive). Unmatched tokens are silently dropped. Capped at 10 templates and at the alert's per-event services limit. Note: this field is an ?include, it will not appear in lists.","items":{"$ref":"#/components/schemas/AlertSourceTemplate"}},"eventTypeFilterCreate":{"type":"string","description":"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."},"eventTypeFilterAccept":{"type":"string","description":"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."},"eventTypeFilterResolve":{"type":"string","description":"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."},"autoRaiseAlerts":{"type":"boolean","description":"Only effective when a support hour is linked to this alert source."},"scoreThreshold":{"type":"number","format":"double","description":"Only used when alertCreation is set to INTELLIGENT_GROUPING."},"severity":{"type":"integer"},"services":{"type":"array","items":{"$ref":"#/components/schemas/Service"}},"setupStatus":{"type":"string","enum":["CREATED","CREATED_ADVANCED","CREATED_BIDIRECTIONAL","FINISHED"]},"autoCreateServices":{"type":"boolean","default":false},"createdAt":{"type":"string","readOnly":true},"updatedAt":{"type":"string","readOnly":true}}},"TeamRel":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"}}},"EscalationPolicy":{"required":["escalationRules","name"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"escalationRules":{"type":"array","items":{"$ref":"#/components/schemas/EscalationRule"}},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}},"repeating":{"type":"boolean","default":false},"frequency":{"maximum":9,"minimum":1,"type":"integer","format":"int32","default":1},"delayMin":{"maximum":15,"minimum":0,"type":"integer","format":"int32","default":0},"routingKey":{"type":"string","description":"optional"}}},"EscalationRule":{"required":["escalationTimeout"],"type":"object","properties":{"escalationTimeout":{"type":"integer"},"user":{"type":"object","properties":{"id":{"type":"number"}},"description":"This field (type: User) is deprecated, please use 'users' instead"},"schedule":{"type":"object","properties":{"id":{"type":"number"}},"description":"This field (type: Schedule) is deprecated, please use 'schedules' instead"},"team":{"type":"object","properties":{"id":{"type":"number"}},"description":"This field (type: Team) is deprecated, please use 'teams' instead"},"users":{"type":"array","items":{"$ref":"#/components/schemas/UserRel"}},"schedules":{"type":"array","items":{"$ref":"#/components/schemas/ScheduleRel"}},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}}}},"UserRel":{"required":["id"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"firstName":{"type":"string"},"lastName":{"type":"string"}}},"ScheduleRel":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"type":{"type":"string","enum":["STATIC","RECURRING"]}}},"IntegrationType":{"type":"string","enum":["NAGIOS","ICINGA","EMAIL2","SMS","API","HEARTBEAT2","PRTG","PINGDOM","CLOUDWATCH","AWSPHD","STACKDRIVER","INSTANA","ZABBIX","SOLARWINDS","PROMETHEUS","NEWRELIC","GRAFANA","GITHUB","DATADOG","UPTIMEROBOT","APPDYNAMICS","DYNATRACE","TOPDESK","STATUSCAKE","MONITOR","TOOL","CHECKMK","AUTOTASK","AWSBUDGET","SYSDIG","SERVERDENSITY","ZAPIER","KENTIXAM","JIRA","CONSUL","ZAMMAD","SPLUNK","SERVICENOW","SEARCHGUARD","KUBERNETES","SIGNALFX","AZUREALERTS","TERRAFORMCLOUD","SENTRY","SEMATEXT","SUMOLOGIC","RAYGUN","MXTOOLBOX","ESWATCHER","AMAZONSNS","KAPACITOR","CORTEXXSOAR","ZENDESK","AUVIK","SENSU","NCENTRAL","JUMPCLOUD","SALESFORCE","GUARDDUTY","STATUSHUB","IXON","APIFORTRESS","FRESHSERVICE","APPSIGNAL","LIGHTSTEP","IBMCLOUDFUNCTIONS","CROWDSTRIKE","HUMIO","OHDEAR","MONGODBATLAS","GITLAB","HYPERPING","PAPRISMACLOUD","SAMSARA","PANDORAFMS","MSSCOM","TWILIO","CISCOMERAKI","CHECKLY","POSTHOG","GOOGLESCC","SLACK","MSTEAMS","UPTIMEKUMA","TWILIOERRORS","PARTICLE","CLOUDFLARE","TULIP","GRAYLOG","CATCHPOINT","LOKI","CORTEX","MIMIR","HALOPSA","INFLUXDB","CALLFLOW","HALOITSM","KIBANA","VICTORIAMETRICS","HONEYCOMB","FOURME","KEEP","UBIDOTS","HETRIXTOOLS","POSTMAN","CLUSTERCONTROL","NETDATA","AWX","KAFKA","MQTT","RAPIDSPIKE","HONEYBADGER","HEALTHCHECKSIO","MEZMO","SERVERGUARD24","CISCOTHOUSANDEYES","SITE24X7","ITCONDUCTOR","SAPFRUN","APICA","DASH0","ROLLBAR","GATUS","LIBRENMS","PANTHER","TEAMCITY","ALIBABACLOUD","FLEETDM","CONNECTWISEPSA","DEADMANSSNITCH","FORTISOAR","OPMANAGER","CRONITOR","DOMOTZ","LIVEWATCH","AZUREDEVOPS","LEVELIO","EKARA","SYSAID","PHAREIO","OPSGENIE","WHATAP","SIGNOZ","GOOGLECHAT","DOTCOMMONITOR","UPTIME","HELPSCOUT","SCIENCELOGIC","PULSETIC","WAZUH","SEKOIA"]},"AlertPriorityRule":{"type":"string","enum":["HIGH","LOW","HIGH_DURING_SUPPORT_HOURS","LOW_DURING_SUPPORT_HOURS"]},"SupportHour":{"required":["name","supportDays","timezone"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}},"timezone":{"$ref":"#/components/schemas/TimeZone"},"supportDays":{"type":"object","properties":{"MONDAY":{"$ref":"#/components/schemas/SupportDay"},"TUESDAY":{"$ref":"#/components/schemas/SupportDay"},"WEDNESDAY":{"$ref":"#/components/schemas/SupportDay"},"THURSDAY":{"$ref":"#/components/schemas/SupportDay"},"FRIDAY":{"$ref":"#/components/schemas/SupportDay"},"SATURDAY":{"$ref":"#/components/schemas/SupportDay"},"SUNDAY":{"$ref":"#/components/schemas/SupportDay"}}},"exceptions":{"type":"array","items":{"$ref":"#/components/schemas/SupportHourException"}}}},"TimeZone":{"type":"string","enum":["Europe/Berlin","America/New_York","America/Los_Angeles","Asia/Istanbul"]},"SupportDay":{"required":["end","start"],"type":"object","properties":{"start":{"type":"string","format":"time"},"end":{"type":"string","format":"time"}}},"SupportHourException":{"type":"object","required":["name","start","end","supportStatus"],"properties":{"name":{"type":"string"},"start":{"type":"string","format":"date"},"end":{"type":"string","format":"date"},"supportStatus":{"type":"string","enum":["DURING","OUTSIDE"]}}},"AlertSourceTemplate":{"type":"object","properties":{"textTemplate":{"type":"string","description":"For more information on alert source templating, please visit: https://docs.ilert.com/alerting/alert-sources#alert-template.\n\n Example: <br />`Hi {{ users[0].name }} there!` \n\nYou can use the text template instead of elements by adding the include `textTemplate` to your request. Any version can be used for POST or PUT requests."},"elements":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourceTemplateElement"}}}},"AlertSourceTemplateElement":{"type":"object","properties":{"type":{"type":"string","enum":["TEXT","VAR","RAW"]},"val":{"type":"string"},"func":{"type":"string"},"args":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourceTemplateElementArg"}}}},"AlertSourceTemplateElementArg":{"type":"object","properties":{"S":{"type":"string"},"N":{"type":"integer"}}},"AlertSourceLinkTemplate":{"required":["hrefTemplate","text"],"type":"object","properties":{"text":{"type":"string"},"hrefTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"}}},"AlertSourcePriorityTemplate":{"required":["mappings","valueTemplate"],"type":"object","properties":{"valueTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"mappings":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourcePriorityTemplateMapping"}}}},"AlertSourcePriorityTemplateMapping":{"required":["priority","value"],"type":"object","properties":{"value":{"type":"string"},"priority":{"type":"string","enum":["LOW","HIGH"]}}},"AlertSourceSeverityTemplate":{"required":["mappings","valueTemplate"],"type":"object","properties":{"valueTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"mappings":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourceSeverityTemplateMapping"}}}},"AlertSourceSeverityTemplateMapping":{"required":["severity","value"],"type":"object","properties":{"value":{"type":"string"},"severity":{"type":"integer","format":"int32"}}},"Service":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"alias":{"type":"string"},"status":{"$ref":"#/components/schemas/ServiceStatus"},"description":{"type":"string"},"oneOpenIncidentOnly":{"type":"boolean"},"showUptimeHistory":{"type":"boolean"},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}},"subscribed":{"type":"boolean","readOnly":true},"uptime":{"$ref":"#/components/schemas/ServiceUptime"},"incidents":{"type":"array","description":"Note that this only contains the latest 10 unresolved incidents, use /api/incidents?service=x if more or specific results are needed","readOnly":true,"items":{"$ref":"#/components/schemas/IncidentNoIncludes"}}}},"ServiceStatus":{"type":"string","description":"the service status","enum":["OPERATIONAL","UNDER_MAINTENANCE","DEGRADED","PARTIAL_OUTAGE","MAJOR_OUTAGE"]},"ServiceUptime":{"type":"object","properties":{"rangeStart":{"type":"string","format":"date-time"},"rangeEnd":{"type":"string","format":"date-time"},"outages":{"type":"array","items":{"$ref":"#/components/schemas/ServiceOutage"}},"uptimePercentage":{"$ref":"#/components/schemas/ServiceUptimePercentage"}}},"ServiceOutage":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/ServiceStatus"},"from":{"type":"string","format":"date-time"},"until":{"type":"string","format":"date-time"}}},"ServiceUptimePercentage":{"type":"object","properties":{"uptimePercentage":{"type":"object","properties":{"p90":{"maximum":100,"minimum":0,"type":"number","format":"float","readOnly":true},"p60":{"maximum":100,"minimum":0,"type":"number","format":"float","readOnly":true},"p30":{"maximum":100,"minimum":0,"type":"number","format":"float","readOnly":true}}}}},"IncidentNoIncludes":{"type":"object","properties":{"id":{"type":"number"},"summary":{"type":"string"},"status":{"$ref":"#/components/schemas/IncidentStatus"},"message":{"type":"string"},"sendNotification":{"type":"boolean"},"createdAt":{"type":"string","description":"May be overwritten during the creation of the incident, otherwise read-only","format":"date-time"},"updatedAt":{"type":"string","description":"May be overwritten during the creation of the incident, otherwise read-only","format":"date-time"},"affectedServices":{"type":"array","items":{"type":"object","properties":{"impact":{"$ref":"#/components/schemas/ServiceStatus"},"service":{"$ref":"#/components/schemas/ServiceNoIncludes"}}}},"resolvedOn":{"type":"string","format":"date-time","readOnly":true}}},"IncidentStatus":{"type":"string","description":"the incident status","enum":["INVESTIGATING","IDENTIFIED","MONITORING","RESOLVED"]},"ServiceNoIncludes":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"alias":{"type":"string"},"status":{"$ref":"#/components/schemas/ServiceStatus"},"description":{"type":"string"},"oneOpenIncidentOnly":{"type":"boolean"},"showUptimeHistory":{"type":"boolean"},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}}}},"AlertActionType":{"type":"string","enum":["autotask","jira","microsoft_teams_bot","microsoft_teams_webhook","servicenow","slack","slack_webhook","webhook","zendesk","discord","github","topdesk","email","zapier","zammad","mattermost","zoom_chat","dingtalk","aws_event_bridge","dynamic","zabbix","automation_rule","telegram","google_chat_bot","google_chat_webhook"]},"CParamsDatadog":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"string"}},"priority":{"type":"string"},"site":{"type":"string"}}},"CParamsJira":{"type":"object","properties":{"project":{"type":"string"},"issueType":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsMicrosoftTeams":{"required":["channelId","teamId"],"type":"object","properties":{"channelId":{"type":"string"},"channelName":{"type":"string"},"teamId":{"type":"string"},"teamName":{"type":"string"},"type":{"type":"string","enum":["chat","meeting"]}}},"CParamsMicrosoftTeamsWebhookOnly":{"type":"object"},"CParamsServiceNow":{"type":"object","properties":{"callerId":{"type":"string"},"impact":{"type":"string"},"urgency":{"type":"string"},"closeCode":{"type":"string"},"assignmentGroup":{"type":"string"},"ownerGroup":{"type":"string"},"service":{"type":"string"},"serviceOffering":{"type":"string"},"contactType":{"type":"string"}}},"CParamsAutotask":{"required":["queueId"],"type":"object","properties":{"companyId":{"type":"string"},"queueId":{"type":"string"},"ticketCategory":{"type":"string"},"ticketType":{"type":"string"},"noteType":{"type":"string"},"notePublish":{"type":"string"},"status":{"type":"string"}}},"CParamsSlack":{"required":["channelId"],"type":"object","properties":{"channelId":{"type":"string"},"channelName":{"type":"string"},"teamDomain":{"type":"string"},"teamId":{"type":"string"}}},"CParamsWebhook":{"required":["webhookUrl"],"type":"object","properties":{"webhookUrl":{"type":"string"},"bodyTemplate":{"type":"string"},"headers":{"type":"array","items":{"type":"object","required":["key","value"],"properties":{"key":{"type":"string"},"value":{"type":"string"}}}}}},"CParamsZendesk":{"type":"object","properties":{"priority":{"type":"string"}}},"CParamsDiscord":{"type":"object"},"CParamsGithub":{"type":"object","properties":{"owner":{"type":"string"},"repository":{"type":"string"},"labels":{"type":"array","items":{"type":"string"}}}},"CParamsTopdesk":{"type":"object","properties":{"status":{"type":"string"}}},"CParamsAWSLambda":{"type":"object","properties":{"webhookUrl":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsAzureFunction":{"type":"object","properties":{"webhookUrl":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsGoogleFunction":{"type":"object","properties":{"webhookUrl":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsEmail":{"type":"object","properties":{"recipients":{"type":"array","items":{"type":"string"}},"subject":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsSysdig":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"string"}},"eventFilter":{"type":"string"}}},"CParamsZapier":{"type":"object","properties":{"webhookUrl":{"type":"string"}}},"CParamsZoomChat":{"type":"object","properties":{"channelId":{"type":"string"}}},"CParamsZoomMeeting":{"type":"object","properties":{"password":{"type":"string"}}},"CParamsStatusPageIO":{"type":"object","properties":{"pageId":{"type":"string"}}},"CParamsDingTalk":{"type":"object","properties":{"isAtAll":{"type":"boolean"},"atMobiles":{"type":"array","items":{"type":"string"}}}},"CParamsDingTalkAction":{"type":"object","properties":{"url":{"type":"string"},"secret":{"type":"string"},"isAtAll":{"type":"boolean"},"atMobiles":{"type":"array","items":{"type":"string"}}}},"CParamsAutomationRule":{"required":["alertType","serviceIds","serviceStatus"],"type":"object","properties":{"alertType":{"type":"string","enum":["CREATED","ACCEPTED"]},"resolveIncident":{"type":"boolean","default":false},"serviceStatus":{"$ref":"#/components/schemas/ServiceStatus"},"templateId":{"type":"integer","format":"int64"},"sendNotification":{"type":"boolean","default":false},"serviceIds":{"type":"array","items":{"type":"integer","format":"int64"}}}},"CParamsTelegram":{"required":["channelId"],"type":"object","properties":{"channelId":{"type":"string","description":"The telegram group id, usually i64, as string"}}},"CParamsGoogleChat":{"required":["channelId"],"type":"object","properties":{"channelId":{"type":"string"},"channelName":{"type":"string"}}},"CParamsGoogleChatWebhookOnly":{"type":"object"}}},"paths":{"/alert-actions":{"post":{"tags":["Alert Actions"],"summary":"Create a new alert action.","requestBody":{"description":"the alert action","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertAction"}}},"required":true},"responses":{"200":{"description":"The newly created alert action","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertAction"}}}}}}}}}
```

## GET /alert-actions/{id}

> Get a specific alert action.

```json
{"openapi":"3.0.1","info":{"title":"ilert REST API","version":"v2.2026.5-r.3"},"tags":[{"name":"Alert Actions"}],"servers":[{"url":"/api"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","description":"The Bearer API key of your user <a href='/api-docs/#section/Authentication'>more info</a>.","name":"Authorization","in":"header"}},"schemas":{"AlertAction":{"required":["connectorType","name"],"type":"object","properties":{"id":{"type":"string"},"alertSources":{"type":"array","items":{"$ref":"#/components/schemas/AlertSource"}},"connectorId":{"type":"string"},"connectorType":{"$ref":"#/components/schemas/AlertActionType"},"name":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"triggerMode":{"type":"string","enum":["AUTOMATIC","MANUAL"]},"bidirectional":{"type":"boolean","readOnly":true},"escalationEndedDelaySec":{"maximum":7200,"minimum":0,"type":"number","description":"May only be used with triggerType 'alert-escalation-ended' selected"},"notResolvedDelaySec":{"maximum":7200,"minimum":0,"type":"number","description":"May only be used with triggerType 'v-alert-not-resolved' selected"},"triggerTypes":{"type":"array","items":{"type":"string","enum":["alert-created","alert-assigned","alert-auto-escalated","alert-acknowledged","alert-raised","alert-comment-added","alert-escalation-ended","alert-resolved","alert-responder-added","alert-responder-removed","alert-channel-attached","alert-channel-detached","v-alert-not-resolved"]}},"alertFilter":{"type":"object","description":"This field is deprecated, use 'conditions' instead. If both are used this field is ignored.","properties":{"operator":{"type":"string","enum":["AND","OR"]},"predicates":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","enum":["ALERT_SUMMARY","ALERT_DETAILS","ESCALATION_POLICY","ALERT_PRIORITY"]},"criteria":{"type":"string","enum":["CONTAINS_ANY_WORDS","CONTAINS_NOT_WORDS","CONTAINS_STRING","CONTAINS_NOT_STRING","IS_STRING","IS_NOT_STRING","MATCHES_REGEX","MATCHES_NOT_REGEX"]},"value":{"type":"string"}}}}}},"conditions":{"type":"string","description":"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."},"params":{"type":"object","oneOf":[{"$ref":"#/components/schemas/CParamsDatadog"},{"$ref":"#/components/schemas/CParamsJira"},{"$ref":"#/components/schemas/CParamsMicrosoftTeams"},{"$ref":"#/components/schemas/CParamsMicrosoftTeamsWebhookOnly"},{"$ref":"#/components/schemas/CParamsServiceNow"},{"$ref":"#/components/schemas/CParamsAutotask"},{"$ref":"#/components/schemas/CParamsSlack"},{"$ref":"#/components/schemas/CParamsWebhook"},{"$ref":"#/components/schemas/CParamsZendesk"},{"$ref":"#/components/schemas/CParamsDiscord"},{"$ref":"#/components/schemas/CParamsGithub"},{"$ref":"#/components/schemas/CParamsTopdesk"},{"$ref":"#/components/schemas/CParamsAWSLambda"},{"$ref":"#/components/schemas/CParamsAzureFunction"},{"$ref":"#/components/schemas/CParamsGoogleFunction"},{"$ref":"#/components/schemas/CParamsEmail"},{"$ref":"#/components/schemas/CParamsSysdig"},{"$ref":"#/components/schemas/CParamsZapier"},{"$ref":"#/components/schemas/CParamsZoomChat"},{"$ref":"#/components/schemas/CParamsZoomMeeting"},{"$ref":"#/components/schemas/CParamsStatusPageIO"},{"$ref":"#/components/schemas/CParamsDingTalk"},{"$ref":"#/components/schemas/CParamsDingTalkAction"},{"$ref":"#/components/schemas/CParamsAutomationRule"},{"$ref":"#/components/schemas/CParamsAutomationRule"},{"$ref":"#/components/schemas/CParamsTelegram"},{"$ref":"#/components/schemas/CParamsGoogleChat"},{"$ref":"#/components/schemas/CParamsGoogleChatWebhookOnly"}]},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}}}},"AlertSource":{"required":["escalationPolicy","integrationType","name"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}},"name":{"type":"string"},"iconUrl":{"type":"string"},"lightIconUrl":{"type":"string"},"darkIconUrl":{"type":"string"},"escalationPolicy":{"$ref":"#/components/schemas/EscalationPolicy"},"integrationType":{"$ref":"#/components/schemas/IntegrationType"},"integrationKey":{"type":"string"},"integrationUrl":{"type":"string","readOnly":true},"autoResolutionTimeout":{"type":"string","format":"ISO-8601"},"alertGroupingWindow":{"type":"string","format":"ISO-8601"},"alertCreation":{"type":"string","default":"ONE_ALERT_PER_EMAIL","enum":["ONE_ALERT_PER_EMAIL","ONE_ALERT_PER_EMAIL_SUBJECT","ONE_PENDING_ALERT_ALLOWED","ONE_OPEN_ALERT_ALLOWED","OPEN_RESOLVE_ON_EXTRACTION","ONE_ALERT_GROUPED_PER_WINDOW","INTELLIGENT_GROUPING"]},"status":{"type":"string","readOnly":true,"enum":["PENDING","ALL_ACCEPTED","ALL_RESOLVED","IN_MAINTENANCE","DISABLED"]},"active":{"type":"boolean","default":true},"alertPriorityRule":{"$ref":"#/components/schemas/AlertPriorityRule"},"supportHours":{"$ref":"#/components/schemas/SupportHour"},"bidirectional":{"type":"boolean","readOnly":true},"summaryTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"detailsTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"routingTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"linkTemplates":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourceLinkTemplate"}},"priorityTemplate":{"$ref":"#/components/schemas/AlertSourcePriorityTemplate"},"severityTemplate":{"$ref":"#/components/schemas/AlertSourceSeverityTemplate"},"eventFilter":{"type":"string","description":"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."},"alertKeyTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"servicesTemplate":{"type":"array","description":"Optional list of templates that extract service identifiers from the inbound event payload. Each rendered value is comma-split, and each resulting token is resolved against the tenant's services by alias or name (case-insensitive). Unmatched tokens are silently dropped. Capped at 10 templates and at the alert's per-event services limit. Note: this field is an ?include, it will not appear in lists.","items":{"$ref":"#/components/schemas/AlertSourceTemplate"}},"eventTypeFilterCreate":{"type":"string","description":"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."},"eventTypeFilterAccept":{"type":"string","description":"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."},"eventTypeFilterResolve":{"type":"string","description":"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."},"autoRaiseAlerts":{"type":"boolean","description":"Only effective when a support hour is linked to this alert source."},"scoreThreshold":{"type":"number","format":"double","description":"Only used when alertCreation is set to INTELLIGENT_GROUPING."},"severity":{"type":"integer"},"services":{"type":"array","items":{"$ref":"#/components/schemas/Service"}},"setupStatus":{"type":"string","enum":["CREATED","CREATED_ADVANCED","CREATED_BIDIRECTIONAL","FINISHED"]},"autoCreateServices":{"type":"boolean","default":false},"createdAt":{"type":"string","readOnly":true},"updatedAt":{"type":"string","readOnly":true}}},"TeamRel":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"}}},"EscalationPolicy":{"required":["escalationRules","name"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"escalationRules":{"type":"array","items":{"$ref":"#/components/schemas/EscalationRule"}},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}},"repeating":{"type":"boolean","default":false},"frequency":{"maximum":9,"minimum":1,"type":"integer","format":"int32","default":1},"delayMin":{"maximum":15,"minimum":0,"type":"integer","format":"int32","default":0},"routingKey":{"type":"string","description":"optional"}}},"EscalationRule":{"required":["escalationTimeout"],"type":"object","properties":{"escalationTimeout":{"type":"integer"},"user":{"type":"object","properties":{"id":{"type":"number"}},"description":"This field (type: User) is deprecated, please use 'users' instead"},"schedule":{"type":"object","properties":{"id":{"type":"number"}},"description":"This field (type: Schedule) is deprecated, please use 'schedules' instead"},"team":{"type":"object","properties":{"id":{"type":"number"}},"description":"This field (type: Team) is deprecated, please use 'teams' instead"},"users":{"type":"array","items":{"$ref":"#/components/schemas/UserRel"}},"schedules":{"type":"array","items":{"$ref":"#/components/schemas/ScheduleRel"}},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}}}},"UserRel":{"required":["id"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"firstName":{"type":"string"},"lastName":{"type":"string"}}},"ScheduleRel":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"type":{"type":"string","enum":["STATIC","RECURRING"]}}},"IntegrationType":{"type":"string","enum":["NAGIOS","ICINGA","EMAIL2","SMS","API","HEARTBEAT2","PRTG","PINGDOM","CLOUDWATCH","AWSPHD","STACKDRIVER","INSTANA","ZABBIX","SOLARWINDS","PROMETHEUS","NEWRELIC","GRAFANA","GITHUB","DATADOG","UPTIMEROBOT","APPDYNAMICS","DYNATRACE","TOPDESK","STATUSCAKE","MONITOR","TOOL","CHECKMK","AUTOTASK","AWSBUDGET","SYSDIG","SERVERDENSITY","ZAPIER","KENTIXAM","JIRA","CONSUL","ZAMMAD","SPLUNK","SERVICENOW","SEARCHGUARD","KUBERNETES","SIGNALFX","AZUREALERTS","TERRAFORMCLOUD","SENTRY","SEMATEXT","SUMOLOGIC","RAYGUN","MXTOOLBOX","ESWATCHER","AMAZONSNS","KAPACITOR","CORTEXXSOAR","ZENDESK","AUVIK","SENSU","NCENTRAL","JUMPCLOUD","SALESFORCE","GUARDDUTY","STATUSHUB","IXON","APIFORTRESS","FRESHSERVICE","APPSIGNAL","LIGHTSTEP","IBMCLOUDFUNCTIONS","CROWDSTRIKE","HUMIO","OHDEAR","MONGODBATLAS","GITLAB","HYPERPING","PAPRISMACLOUD","SAMSARA","PANDORAFMS","MSSCOM","TWILIO","CISCOMERAKI","CHECKLY","POSTHOG","GOOGLESCC","SLACK","MSTEAMS","UPTIMEKUMA","TWILIOERRORS","PARTICLE","CLOUDFLARE","TULIP","GRAYLOG","CATCHPOINT","LOKI","CORTEX","MIMIR","HALOPSA","INFLUXDB","CALLFLOW","HALOITSM","KIBANA","VICTORIAMETRICS","HONEYCOMB","FOURME","KEEP","UBIDOTS","HETRIXTOOLS","POSTMAN","CLUSTERCONTROL","NETDATA","AWX","KAFKA","MQTT","RAPIDSPIKE","HONEYBADGER","HEALTHCHECKSIO","MEZMO","SERVERGUARD24","CISCOTHOUSANDEYES","SITE24X7","ITCONDUCTOR","SAPFRUN","APICA","DASH0","ROLLBAR","GATUS","LIBRENMS","PANTHER","TEAMCITY","ALIBABACLOUD","FLEETDM","CONNECTWISEPSA","DEADMANSSNITCH","FORTISOAR","OPMANAGER","CRONITOR","DOMOTZ","LIVEWATCH","AZUREDEVOPS","LEVELIO","EKARA","SYSAID","PHAREIO","OPSGENIE","WHATAP","SIGNOZ","GOOGLECHAT","DOTCOMMONITOR","UPTIME","HELPSCOUT","SCIENCELOGIC","PULSETIC","WAZUH","SEKOIA"]},"AlertPriorityRule":{"type":"string","enum":["HIGH","LOW","HIGH_DURING_SUPPORT_HOURS","LOW_DURING_SUPPORT_HOURS"]},"SupportHour":{"required":["name","supportDays","timezone"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}},"timezone":{"$ref":"#/components/schemas/TimeZone"},"supportDays":{"type":"object","properties":{"MONDAY":{"$ref":"#/components/schemas/SupportDay"},"TUESDAY":{"$ref":"#/components/schemas/SupportDay"},"WEDNESDAY":{"$ref":"#/components/schemas/SupportDay"},"THURSDAY":{"$ref":"#/components/schemas/SupportDay"},"FRIDAY":{"$ref":"#/components/schemas/SupportDay"},"SATURDAY":{"$ref":"#/components/schemas/SupportDay"},"SUNDAY":{"$ref":"#/components/schemas/SupportDay"}}},"exceptions":{"type":"array","items":{"$ref":"#/components/schemas/SupportHourException"}}}},"TimeZone":{"type":"string","enum":["Europe/Berlin","America/New_York","America/Los_Angeles","Asia/Istanbul"]},"SupportDay":{"required":["end","start"],"type":"object","properties":{"start":{"type":"string","format":"time"},"end":{"type":"string","format":"time"}}},"SupportHourException":{"type":"object","required":["name","start","end","supportStatus"],"properties":{"name":{"type":"string"},"start":{"type":"string","format":"date"},"end":{"type":"string","format":"date"},"supportStatus":{"type":"string","enum":["DURING","OUTSIDE"]}}},"AlertSourceTemplate":{"type":"object","properties":{"textTemplate":{"type":"string","description":"For more information on alert source templating, please visit: https://docs.ilert.com/alerting/alert-sources#alert-template.\n\n Example: <br />`Hi {{ users[0].name }} there!` \n\nYou can use the text template instead of elements by adding the include `textTemplate` to your request. Any version can be used for POST or PUT requests."},"elements":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourceTemplateElement"}}}},"AlertSourceTemplateElement":{"type":"object","properties":{"type":{"type":"string","enum":["TEXT","VAR","RAW"]},"val":{"type":"string"},"func":{"type":"string"},"args":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourceTemplateElementArg"}}}},"AlertSourceTemplateElementArg":{"type":"object","properties":{"S":{"type":"string"},"N":{"type":"integer"}}},"AlertSourceLinkTemplate":{"required":["hrefTemplate","text"],"type":"object","properties":{"text":{"type":"string"},"hrefTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"}}},"AlertSourcePriorityTemplate":{"required":["mappings","valueTemplate"],"type":"object","properties":{"valueTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"mappings":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourcePriorityTemplateMapping"}}}},"AlertSourcePriorityTemplateMapping":{"required":["priority","value"],"type":"object","properties":{"value":{"type":"string"},"priority":{"type":"string","enum":["LOW","HIGH"]}}},"AlertSourceSeverityTemplate":{"required":["mappings","valueTemplate"],"type":"object","properties":{"valueTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"mappings":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourceSeverityTemplateMapping"}}}},"AlertSourceSeverityTemplateMapping":{"required":["severity","value"],"type":"object","properties":{"value":{"type":"string"},"severity":{"type":"integer","format":"int32"}}},"Service":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"alias":{"type":"string"},"status":{"$ref":"#/components/schemas/ServiceStatus"},"description":{"type":"string"},"oneOpenIncidentOnly":{"type":"boolean"},"showUptimeHistory":{"type":"boolean"},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}},"subscribed":{"type":"boolean","readOnly":true},"uptime":{"$ref":"#/components/schemas/ServiceUptime"},"incidents":{"type":"array","description":"Note that this only contains the latest 10 unresolved incidents, use /api/incidents?service=x if more or specific results are needed","readOnly":true,"items":{"$ref":"#/components/schemas/IncidentNoIncludes"}}}},"ServiceStatus":{"type":"string","description":"the service status","enum":["OPERATIONAL","UNDER_MAINTENANCE","DEGRADED","PARTIAL_OUTAGE","MAJOR_OUTAGE"]},"ServiceUptime":{"type":"object","properties":{"rangeStart":{"type":"string","format":"date-time"},"rangeEnd":{"type":"string","format":"date-time"},"outages":{"type":"array","items":{"$ref":"#/components/schemas/ServiceOutage"}},"uptimePercentage":{"$ref":"#/components/schemas/ServiceUptimePercentage"}}},"ServiceOutage":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/ServiceStatus"},"from":{"type":"string","format":"date-time"},"until":{"type":"string","format":"date-time"}}},"ServiceUptimePercentage":{"type":"object","properties":{"uptimePercentage":{"type":"object","properties":{"p90":{"maximum":100,"minimum":0,"type":"number","format":"float","readOnly":true},"p60":{"maximum":100,"minimum":0,"type":"number","format":"float","readOnly":true},"p30":{"maximum":100,"minimum":0,"type":"number","format":"float","readOnly":true}}}}},"IncidentNoIncludes":{"type":"object","properties":{"id":{"type":"number"},"summary":{"type":"string"},"status":{"$ref":"#/components/schemas/IncidentStatus"},"message":{"type":"string"},"sendNotification":{"type":"boolean"},"createdAt":{"type":"string","description":"May be overwritten during the creation of the incident, otherwise read-only","format":"date-time"},"updatedAt":{"type":"string","description":"May be overwritten during the creation of the incident, otherwise read-only","format":"date-time"},"affectedServices":{"type":"array","items":{"type":"object","properties":{"impact":{"$ref":"#/components/schemas/ServiceStatus"},"service":{"$ref":"#/components/schemas/ServiceNoIncludes"}}}},"resolvedOn":{"type":"string","format":"date-time","readOnly":true}}},"IncidentStatus":{"type":"string","description":"the incident status","enum":["INVESTIGATING","IDENTIFIED","MONITORING","RESOLVED"]},"ServiceNoIncludes":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"alias":{"type":"string"},"status":{"$ref":"#/components/schemas/ServiceStatus"},"description":{"type":"string"},"oneOpenIncidentOnly":{"type":"boolean"},"showUptimeHistory":{"type":"boolean"},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}}}},"AlertActionType":{"type":"string","enum":["autotask","jira","microsoft_teams_bot","microsoft_teams_webhook","servicenow","slack","slack_webhook","webhook","zendesk","discord","github","topdesk","email","zapier","zammad","mattermost","zoom_chat","dingtalk","aws_event_bridge","dynamic","zabbix","automation_rule","telegram","google_chat_bot","google_chat_webhook"]},"CParamsDatadog":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"string"}},"priority":{"type":"string"},"site":{"type":"string"}}},"CParamsJira":{"type":"object","properties":{"project":{"type":"string"},"issueType":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsMicrosoftTeams":{"required":["channelId","teamId"],"type":"object","properties":{"channelId":{"type":"string"},"channelName":{"type":"string"},"teamId":{"type":"string"},"teamName":{"type":"string"},"type":{"type":"string","enum":["chat","meeting"]}}},"CParamsMicrosoftTeamsWebhookOnly":{"type":"object"},"CParamsServiceNow":{"type":"object","properties":{"callerId":{"type":"string"},"impact":{"type":"string"},"urgency":{"type":"string"},"closeCode":{"type":"string"},"assignmentGroup":{"type":"string"},"ownerGroup":{"type":"string"},"service":{"type":"string"},"serviceOffering":{"type":"string"},"contactType":{"type":"string"}}},"CParamsAutotask":{"required":["queueId"],"type":"object","properties":{"companyId":{"type":"string"},"queueId":{"type":"string"},"ticketCategory":{"type":"string"},"ticketType":{"type":"string"},"noteType":{"type":"string"},"notePublish":{"type":"string"},"status":{"type":"string"}}},"CParamsSlack":{"required":["channelId"],"type":"object","properties":{"channelId":{"type":"string"},"channelName":{"type":"string"},"teamDomain":{"type":"string"},"teamId":{"type":"string"}}},"CParamsWebhook":{"required":["webhookUrl"],"type":"object","properties":{"webhookUrl":{"type":"string"},"bodyTemplate":{"type":"string"},"headers":{"type":"array","items":{"type":"object","required":["key","value"],"properties":{"key":{"type":"string"},"value":{"type":"string"}}}}}},"CParamsZendesk":{"type":"object","properties":{"priority":{"type":"string"}}},"CParamsDiscord":{"type":"object"},"CParamsGithub":{"type":"object","properties":{"owner":{"type":"string"},"repository":{"type":"string"},"labels":{"type":"array","items":{"type":"string"}}}},"CParamsTopdesk":{"type":"object","properties":{"status":{"type":"string"}}},"CParamsAWSLambda":{"type":"object","properties":{"webhookUrl":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsAzureFunction":{"type":"object","properties":{"webhookUrl":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsGoogleFunction":{"type":"object","properties":{"webhookUrl":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsEmail":{"type":"object","properties":{"recipients":{"type":"array","items":{"type":"string"}},"subject":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsSysdig":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"string"}},"eventFilter":{"type":"string"}}},"CParamsZapier":{"type":"object","properties":{"webhookUrl":{"type":"string"}}},"CParamsZoomChat":{"type":"object","properties":{"channelId":{"type":"string"}}},"CParamsZoomMeeting":{"type":"object","properties":{"password":{"type":"string"}}},"CParamsStatusPageIO":{"type":"object","properties":{"pageId":{"type":"string"}}},"CParamsDingTalk":{"type":"object","properties":{"isAtAll":{"type":"boolean"},"atMobiles":{"type":"array","items":{"type":"string"}}}},"CParamsDingTalkAction":{"type":"object","properties":{"url":{"type":"string"},"secret":{"type":"string"},"isAtAll":{"type":"boolean"},"atMobiles":{"type":"array","items":{"type":"string"}}}},"CParamsAutomationRule":{"required":["alertType","serviceIds","serviceStatus"],"type":"object","properties":{"alertType":{"type":"string","enum":["CREATED","ACCEPTED"]},"resolveIncident":{"type":"boolean","default":false},"serviceStatus":{"$ref":"#/components/schemas/ServiceStatus"},"templateId":{"type":"integer","format":"int64"},"sendNotification":{"type":"boolean","default":false},"serviceIds":{"type":"array","items":{"type":"integer","format":"int64"}}}},"CParamsTelegram":{"required":["channelId"],"type":"object","properties":{"channelId":{"type":"string","description":"The telegram group id, usually i64, as string"}}},"CParamsGoogleChat":{"required":["channelId"],"type":"object","properties":{"channelId":{"type":"string"},"channelName":{"type":"string"}}},"CParamsGoogleChatWebhookOnly":{"type":"object"}}},"paths":{"/alert-actions/{id}":{"get":{"tags":["Alert Actions"],"summary":"Get a specific alert action.","parameters":[{"name":"id","in":"path","description":"entity ID","required":true,"schema":{"type":"string"}},{"name":"include","in":"query","description":"Describes optional properties that should be included in the response. You may declare multiple. (conditions); some may not work in lists; may be used for POST and PUT as well.","style":"form","explode":true,"schema":{"type":"array","items":{"type":"string","enum":["conditions"]}}}],"responses":{"200":{"description":"The requested alert action","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertAction"}}}}}}}}}
```

## PUT /alert-actions/{id}

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

```json
{"openapi":"3.0.1","info":{"title":"ilert REST API","version":"v2.2026.5-r.3"},"tags":[{"name":"Alert Actions"}],"servers":[{"url":"/api"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","description":"The Bearer API key of your user <a href='/api-docs/#section/Authentication'>more info</a>.","name":"Authorization","in":"header"}},"schemas":{"AlertAction":{"required":["connectorType","name"],"type":"object","properties":{"id":{"type":"string"},"alertSources":{"type":"array","items":{"$ref":"#/components/schemas/AlertSource"}},"connectorId":{"type":"string"},"connectorType":{"$ref":"#/components/schemas/AlertActionType"},"name":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"triggerMode":{"type":"string","enum":["AUTOMATIC","MANUAL"]},"bidirectional":{"type":"boolean","readOnly":true},"escalationEndedDelaySec":{"maximum":7200,"minimum":0,"type":"number","description":"May only be used with triggerType 'alert-escalation-ended' selected"},"notResolvedDelaySec":{"maximum":7200,"minimum":0,"type":"number","description":"May only be used with triggerType 'v-alert-not-resolved' selected"},"triggerTypes":{"type":"array","items":{"type":"string","enum":["alert-created","alert-assigned","alert-auto-escalated","alert-acknowledged","alert-raised","alert-comment-added","alert-escalation-ended","alert-resolved","alert-responder-added","alert-responder-removed","alert-channel-attached","alert-channel-detached","v-alert-not-resolved"]}},"alertFilter":{"type":"object","description":"This field is deprecated, use 'conditions' instead. If both are used this field is ignored.","properties":{"operator":{"type":"string","enum":["AND","OR"]},"predicates":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","enum":["ALERT_SUMMARY","ALERT_DETAILS","ESCALATION_POLICY","ALERT_PRIORITY"]},"criteria":{"type":"string","enum":["CONTAINS_ANY_WORDS","CONTAINS_NOT_WORDS","CONTAINS_STRING","CONTAINS_NOT_STRING","IS_STRING","IS_NOT_STRING","MATCHES_REGEX","MATCHES_NOT_REGEX"]},"value":{"type":"string"}}}}}},"conditions":{"type":"string","description":"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."},"params":{"type":"object","oneOf":[{"$ref":"#/components/schemas/CParamsDatadog"},{"$ref":"#/components/schemas/CParamsJira"},{"$ref":"#/components/schemas/CParamsMicrosoftTeams"},{"$ref":"#/components/schemas/CParamsMicrosoftTeamsWebhookOnly"},{"$ref":"#/components/schemas/CParamsServiceNow"},{"$ref":"#/components/schemas/CParamsAutotask"},{"$ref":"#/components/schemas/CParamsSlack"},{"$ref":"#/components/schemas/CParamsWebhook"},{"$ref":"#/components/schemas/CParamsZendesk"},{"$ref":"#/components/schemas/CParamsDiscord"},{"$ref":"#/components/schemas/CParamsGithub"},{"$ref":"#/components/schemas/CParamsTopdesk"},{"$ref":"#/components/schemas/CParamsAWSLambda"},{"$ref":"#/components/schemas/CParamsAzureFunction"},{"$ref":"#/components/schemas/CParamsGoogleFunction"},{"$ref":"#/components/schemas/CParamsEmail"},{"$ref":"#/components/schemas/CParamsSysdig"},{"$ref":"#/components/schemas/CParamsZapier"},{"$ref":"#/components/schemas/CParamsZoomChat"},{"$ref":"#/components/schemas/CParamsZoomMeeting"},{"$ref":"#/components/schemas/CParamsStatusPageIO"},{"$ref":"#/components/schemas/CParamsDingTalk"},{"$ref":"#/components/schemas/CParamsDingTalkAction"},{"$ref":"#/components/schemas/CParamsAutomationRule"},{"$ref":"#/components/schemas/CParamsAutomationRule"},{"$ref":"#/components/schemas/CParamsTelegram"},{"$ref":"#/components/schemas/CParamsGoogleChat"},{"$ref":"#/components/schemas/CParamsGoogleChatWebhookOnly"}]},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}}}},"AlertSource":{"required":["escalationPolicy","integrationType","name"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}},"name":{"type":"string"},"iconUrl":{"type":"string"},"lightIconUrl":{"type":"string"},"darkIconUrl":{"type":"string"},"escalationPolicy":{"$ref":"#/components/schemas/EscalationPolicy"},"integrationType":{"$ref":"#/components/schemas/IntegrationType"},"integrationKey":{"type":"string"},"integrationUrl":{"type":"string","readOnly":true},"autoResolutionTimeout":{"type":"string","format":"ISO-8601"},"alertGroupingWindow":{"type":"string","format":"ISO-8601"},"alertCreation":{"type":"string","default":"ONE_ALERT_PER_EMAIL","enum":["ONE_ALERT_PER_EMAIL","ONE_ALERT_PER_EMAIL_SUBJECT","ONE_PENDING_ALERT_ALLOWED","ONE_OPEN_ALERT_ALLOWED","OPEN_RESOLVE_ON_EXTRACTION","ONE_ALERT_GROUPED_PER_WINDOW","INTELLIGENT_GROUPING"]},"status":{"type":"string","readOnly":true,"enum":["PENDING","ALL_ACCEPTED","ALL_RESOLVED","IN_MAINTENANCE","DISABLED"]},"active":{"type":"boolean","default":true},"alertPriorityRule":{"$ref":"#/components/schemas/AlertPriorityRule"},"supportHours":{"$ref":"#/components/schemas/SupportHour"},"bidirectional":{"type":"boolean","readOnly":true},"summaryTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"detailsTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"routingTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"linkTemplates":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourceLinkTemplate"}},"priorityTemplate":{"$ref":"#/components/schemas/AlertSourcePriorityTemplate"},"severityTemplate":{"$ref":"#/components/schemas/AlertSourceSeverityTemplate"},"eventFilter":{"type":"string","description":"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."},"alertKeyTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"servicesTemplate":{"type":"array","description":"Optional list of templates that extract service identifiers from the inbound event payload. Each rendered value is comma-split, and each resulting token is resolved against the tenant's services by alias or name (case-insensitive). Unmatched tokens are silently dropped. Capped at 10 templates and at the alert's per-event services limit. Note: this field is an ?include, it will not appear in lists.","items":{"$ref":"#/components/schemas/AlertSourceTemplate"}},"eventTypeFilterCreate":{"type":"string","description":"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."},"eventTypeFilterAccept":{"type":"string","description":"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."},"eventTypeFilterResolve":{"type":"string","description":"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."},"autoRaiseAlerts":{"type":"boolean","description":"Only effective when a support hour is linked to this alert source."},"scoreThreshold":{"type":"number","format":"double","description":"Only used when alertCreation is set to INTELLIGENT_GROUPING."},"severity":{"type":"integer"},"services":{"type":"array","items":{"$ref":"#/components/schemas/Service"}},"setupStatus":{"type":"string","enum":["CREATED","CREATED_ADVANCED","CREATED_BIDIRECTIONAL","FINISHED"]},"autoCreateServices":{"type":"boolean","default":false},"createdAt":{"type":"string","readOnly":true},"updatedAt":{"type":"string","readOnly":true}}},"TeamRel":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"}}},"EscalationPolicy":{"required":["escalationRules","name"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"escalationRules":{"type":"array","items":{"$ref":"#/components/schemas/EscalationRule"}},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}},"repeating":{"type":"boolean","default":false},"frequency":{"maximum":9,"minimum":1,"type":"integer","format":"int32","default":1},"delayMin":{"maximum":15,"minimum":0,"type":"integer","format":"int32","default":0},"routingKey":{"type":"string","description":"optional"}}},"EscalationRule":{"required":["escalationTimeout"],"type":"object","properties":{"escalationTimeout":{"type":"integer"},"user":{"type":"object","properties":{"id":{"type":"number"}},"description":"This field (type: User) is deprecated, please use 'users' instead"},"schedule":{"type":"object","properties":{"id":{"type":"number"}},"description":"This field (type: Schedule) is deprecated, please use 'schedules' instead"},"team":{"type":"object","properties":{"id":{"type":"number"}},"description":"This field (type: Team) is deprecated, please use 'teams' instead"},"users":{"type":"array","items":{"$ref":"#/components/schemas/UserRel"}},"schedules":{"type":"array","items":{"$ref":"#/components/schemas/ScheduleRel"}},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}}}},"UserRel":{"required":["id"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"firstName":{"type":"string"},"lastName":{"type":"string"}}},"ScheduleRel":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"type":{"type":"string","enum":["STATIC","RECURRING"]}}},"IntegrationType":{"type":"string","enum":["NAGIOS","ICINGA","EMAIL2","SMS","API","HEARTBEAT2","PRTG","PINGDOM","CLOUDWATCH","AWSPHD","STACKDRIVER","INSTANA","ZABBIX","SOLARWINDS","PROMETHEUS","NEWRELIC","GRAFANA","GITHUB","DATADOG","UPTIMEROBOT","APPDYNAMICS","DYNATRACE","TOPDESK","STATUSCAKE","MONITOR","TOOL","CHECKMK","AUTOTASK","AWSBUDGET","SYSDIG","SERVERDENSITY","ZAPIER","KENTIXAM","JIRA","CONSUL","ZAMMAD","SPLUNK","SERVICENOW","SEARCHGUARD","KUBERNETES","SIGNALFX","AZUREALERTS","TERRAFORMCLOUD","SENTRY","SEMATEXT","SUMOLOGIC","RAYGUN","MXTOOLBOX","ESWATCHER","AMAZONSNS","KAPACITOR","CORTEXXSOAR","ZENDESK","AUVIK","SENSU","NCENTRAL","JUMPCLOUD","SALESFORCE","GUARDDUTY","STATUSHUB","IXON","APIFORTRESS","FRESHSERVICE","APPSIGNAL","LIGHTSTEP","IBMCLOUDFUNCTIONS","CROWDSTRIKE","HUMIO","OHDEAR","MONGODBATLAS","GITLAB","HYPERPING","PAPRISMACLOUD","SAMSARA","PANDORAFMS","MSSCOM","TWILIO","CISCOMERAKI","CHECKLY","POSTHOG","GOOGLESCC","SLACK","MSTEAMS","UPTIMEKUMA","TWILIOERRORS","PARTICLE","CLOUDFLARE","TULIP","GRAYLOG","CATCHPOINT","LOKI","CORTEX","MIMIR","HALOPSA","INFLUXDB","CALLFLOW","HALOITSM","KIBANA","VICTORIAMETRICS","HONEYCOMB","FOURME","KEEP","UBIDOTS","HETRIXTOOLS","POSTMAN","CLUSTERCONTROL","NETDATA","AWX","KAFKA","MQTT","RAPIDSPIKE","HONEYBADGER","HEALTHCHECKSIO","MEZMO","SERVERGUARD24","CISCOTHOUSANDEYES","SITE24X7","ITCONDUCTOR","SAPFRUN","APICA","DASH0","ROLLBAR","GATUS","LIBRENMS","PANTHER","TEAMCITY","ALIBABACLOUD","FLEETDM","CONNECTWISEPSA","DEADMANSSNITCH","FORTISOAR","OPMANAGER","CRONITOR","DOMOTZ","LIVEWATCH","AZUREDEVOPS","LEVELIO","EKARA","SYSAID","PHAREIO","OPSGENIE","WHATAP","SIGNOZ","GOOGLECHAT","DOTCOMMONITOR","UPTIME","HELPSCOUT","SCIENCELOGIC","PULSETIC","WAZUH","SEKOIA"]},"AlertPriorityRule":{"type":"string","enum":["HIGH","LOW","HIGH_DURING_SUPPORT_HOURS","LOW_DURING_SUPPORT_HOURS"]},"SupportHour":{"required":["name","supportDays","timezone"],"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}},"timezone":{"$ref":"#/components/schemas/TimeZone"},"supportDays":{"type":"object","properties":{"MONDAY":{"$ref":"#/components/schemas/SupportDay"},"TUESDAY":{"$ref":"#/components/schemas/SupportDay"},"WEDNESDAY":{"$ref":"#/components/schemas/SupportDay"},"THURSDAY":{"$ref":"#/components/schemas/SupportDay"},"FRIDAY":{"$ref":"#/components/schemas/SupportDay"},"SATURDAY":{"$ref":"#/components/schemas/SupportDay"},"SUNDAY":{"$ref":"#/components/schemas/SupportDay"}}},"exceptions":{"type":"array","items":{"$ref":"#/components/schemas/SupportHourException"}}}},"TimeZone":{"type":"string","enum":["Europe/Berlin","America/New_York","America/Los_Angeles","Asia/Istanbul"]},"SupportDay":{"required":["end","start"],"type":"object","properties":{"start":{"type":"string","format":"time"},"end":{"type":"string","format":"time"}}},"SupportHourException":{"type":"object","required":["name","start","end","supportStatus"],"properties":{"name":{"type":"string"},"start":{"type":"string","format":"date"},"end":{"type":"string","format":"date"},"supportStatus":{"type":"string","enum":["DURING","OUTSIDE"]}}},"AlertSourceTemplate":{"type":"object","properties":{"textTemplate":{"type":"string","description":"For more information on alert source templating, please visit: https://docs.ilert.com/alerting/alert-sources#alert-template.\n\n Example: <br />`Hi {{ users[0].name }} there!` \n\nYou can use the text template instead of elements by adding the include `textTemplate` to your request. Any version can be used for POST or PUT requests."},"elements":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourceTemplateElement"}}}},"AlertSourceTemplateElement":{"type":"object","properties":{"type":{"type":"string","enum":["TEXT","VAR","RAW"]},"val":{"type":"string"},"func":{"type":"string"},"args":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourceTemplateElementArg"}}}},"AlertSourceTemplateElementArg":{"type":"object","properties":{"S":{"type":"string"},"N":{"type":"integer"}}},"AlertSourceLinkTemplate":{"required":["hrefTemplate","text"],"type":"object","properties":{"text":{"type":"string"},"hrefTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"}}},"AlertSourcePriorityTemplate":{"required":["mappings","valueTemplate"],"type":"object","properties":{"valueTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"mappings":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourcePriorityTemplateMapping"}}}},"AlertSourcePriorityTemplateMapping":{"required":["priority","value"],"type":"object","properties":{"value":{"type":"string"},"priority":{"type":"string","enum":["LOW","HIGH"]}}},"AlertSourceSeverityTemplate":{"required":["mappings","valueTemplate"],"type":"object","properties":{"valueTemplate":{"$ref":"#/components/schemas/AlertSourceTemplate"},"mappings":{"type":"array","items":{"$ref":"#/components/schemas/AlertSourceSeverityTemplateMapping"}}}},"AlertSourceSeverityTemplateMapping":{"required":["severity","value"],"type":"object","properties":{"value":{"type":"string"},"severity":{"type":"integer","format":"int32"}}},"Service":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"alias":{"type":"string"},"status":{"$ref":"#/components/schemas/ServiceStatus"},"description":{"type":"string"},"oneOpenIncidentOnly":{"type":"boolean"},"showUptimeHistory":{"type":"boolean"},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}},"subscribed":{"type":"boolean","readOnly":true},"uptime":{"$ref":"#/components/schemas/ServiceUptime"},"incidents":{"type":"array","description":"Note that this only contains the latest 10 unresolved incidents, use /api/incidents?service=x if more or specific results are needed","readOnly":true,"items":{"$ref":"#/components/schemas/IncidentNoIncludes"}}}},"ServiceStatus":{"type":"string","description":"the service status","enum":["OPERATIONAL","UNDER_MAINTENANCE","DEGRADED","PARTIAL_OUTAGE","MAJOR_OUTAGE"]},"ServiceUptime":{"type":"object","properties":{"rangeStart":{"type":"string","format":"date-time"},"rangeEnd":{"type":"string","format":"date-time"},"outages":{"type":"array","items":{"$ref":"#/components/schemas/ServiceOutage"}},"uptimePercentage":{"$ref":"#/components/schemas/ServiceUptimePercentage"}}},"ServiceOutage":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/ServiceStatus"},"from":{"type":"string","format":"date-time"},"until":{"type":"string","format":"date-time"}}},"ServiceUptimePercentage":{"type":"object","properties":{"uptimePercentage":{"type":"object","properties":{"p90":{"maximum":100,"minimum":0,"type":"number","format":"float","readOnly":true},"p60":{"maximum":100,"minimum":0,"type":"number","format":"float","readOnly":true},"p30":{"maximum":100,"minimum":0,"type":"number","format":"float","readOnly":true}}}}},"IncidentNoIncludes":{"type":"object","properties":{"id":{"type":"number"},"summary":{"type":"string"},"status":{"$ref":"#/components/schemas/IncidentStatus"},"message":{"type":"string"},"sendNotification":{"type":"boolean"},"createdAt":{"type":"string","description":"May be overwritten during the creation of the incident, otherwise read-only","format":"date-time"},"updatedAt":{"type":"string","description":"May be overwritten during the creation of the incident, otherwise read-only","format":"date-time"},"affectedServices":{"type":"array","items":{"type":"object","properties":{"impact":{"$ref":"#/components/schemas/ServiceStatus"},"service":{"$ref":"#/components/schemas/ServiceNoIncludes"}}}},"resolvedOn":{"type":"string","format":"date-time","readOnly":true}}},"IncidentStatus":{"type":"string","description":"the incident status","enum":["INVESTIGATING","IDENTIFIED","MONITORING","RESOLVED"]},"ServiceNoIncludes":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"alias":{"type":"string"},"status":{"$ref":"#/components/schemas/ServiceStatus"},"description":{"type":"string"},"oneOpenIncidentOnly":{"type":"boolean"},"showUptimeHistory":{"type":"boolean"},"teams":{"type":"array","items":{"$ref":"#/components/schemas/TeamRel"}}}},"AlertActionType":{"type":"string","enum":["autotask","jira","microsoft_teams_bot","microsoft_teams_webhook","servicenow","slack","slack_webhook","webhook","zendesk","discord","github","topdesk","email","zapier","zammad","mattermost","zoom_chat","dingtalk","aws_event_bridge","dynamic","zabbix","automation_rule","telegram","google_chat_bot","google_chat_webhook"]},"CParamsDatadog":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"string"}},"priority":{"type":"string"},"site":{"type":"string"}}},"CParamsJira":{"type":"object","properties":{"project":{"type":"string"},"issueType":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsMicrosoftTeams":{"required":["channelId","teamId"],"type":"object","properties":{"channelId":{"type":"string"},"channelName":{"type":"string"},"teamId":{"type":"string"},"teamName":{"type":"string"},"type":{"type":"string","enum":["chat","meeting"]}}},"CParamsMicrosoftTeamsWebhookOnly":{"type":"object"},"CParamsServiceNow":{"type":"object","properties":{"callerId":{"type":"string"},"impact":{"type":"string"},"urgency":{"type":"string"},"closeCode":{"type":"string"},"assignmentGroup":{"type":"string"},"ownerGroup":{"type":"string"},"service":{"type":"string"},"serviceOffering":{"type":"string"},"contactType":{"type":"string"}}},"CParamsAutotask":{"required":["queueId"],"type":"object","properties":{"companyId":{"type":"string"},"queueId":{"type":"string"},"ticketCategory":{"type":"string"},"ticketType":{"type":"string"},"noteType":{"type":"string"},"notePublish":{"type":"string"},"status":{"type":"string"}}},"CParamsSlack":{"required":["channelId"],"type":"object","properties":{"channelId":{"type":"string"},"channelName":{"type":"string"},"teamDomain":{"type":"string"},"teamId":{"type":"string"}}},"CParamsWebhook":{"required":["webhookUrl"],"type":"object","properties":{"webhookUrl":{"type":"string"},"bodyTemplate":{"type":"string"},"headers":{"type":"array","items":{"type":"object","required":["key","value"],"properties":{"key":{"type":"string"},"value":{"type":"string"}}}}}},"CParamsZendesk":{"type":"object","properties":{"priority":{"type":"string"}}},"CParamsDiscord":{"type":"object"},"CParamsGithub":{"type":"object","properties":{"owner":{"type":"string"},"repository":{"type":"string"},"labels":{"type":"array","items":{"type":"string"}}}},"CParamsTopdesk":{"type":"object","properties":{"status":{"type":"string"}}},"CParamsAWSLambda":{"type":"object","properties":{"webhookUrl":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsAzureFunction":{"type":"object","properties":{"webhookUrl":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsGoogleFunction":{"type":"object","properties":{"webhookUrl":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsEmail":{"type":"object","properties":{"recipients":{"type":"array","items":{"type":"string"}},"subject":{"type":"string"},"bodyTemplate":{"type":"string"}}},"CParamsSysdig":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"string"}},"eventFilter":{"type":"string"}}},"CParamsZapier":{"type":"object","properties":{"webhookUrl":{"type":"string"}}},"CParamsZoomChat":{"type":"object","properties":{"channelId":{"type":"string"}}},"CParamsZoomMeeting":{"type":"object","properties":{"password":{"type":"string"}}},"CParamsStatusPageIO":{"type":"object","properties":{"pageId":{"type":"string"}}},"CParamsDingTalk":{"type":"object","properties":{"isAtAll":{"type":"boolean"},"atMobiles":{"type":"array","items":{"type":"string"}}}},"CParamsDingTalkAction":{"type":"object","properties":{"url":{"type":"string"},"secret":{"type":"string"},"isAtAll":{"type":"boolean"},"atMobiles":{"type":"array","items":{"type":"string"}}}},"CParamsAutomationRule":{"required":["alertType","serviceIds","serviceStatus"],"type":"object","properties":{"alertType":{"type":"string","enum":["CREATED","ACCEPTED"]},"resolveIncident":{"type":"boolean","default":false},"serviceStatus":{"$ref":"#/components/schemas/ServiceStatus"},"templateId":{"type":"integer","format":"int64"},"sendNotification":{"type":"boolean","default":false},"serviceIds":{"type":"array","items":{"type":"integer","format":"int64"}}}},"CParamsTelegram":{"required":["channelId"],"type":"object","properties":{"channelId":{"type":"string","description":"The telegram group id, usually i64, as string"}}},"CParamsGoogleChat":{"required":["channelId"],"type":"object","properties":{"channelId":{"type":"string"},"channelName":{"type":"string"}}},"CParamsGoogleChatWebhookOnly":{"type":"object"}}},"paths":{"/alert-actions/{id}":{"put":{"tags":["Alert Actions"],"summary":"Update the specific alert action. (note: type cannot be changed)","parameters":[{"name":"id","in":"path","description":"entity ID","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"the alert action","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertAction"}}},"required":true},"responses":{"200":{"description":"The updated alert action","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertAction"}}}}}}}}}
```

## DELETE /alert-actions/{id}

> Remove a specific alert action.

```json
{"openapi":"3.0.1","info":{"title":"ilert REST API","version":"v2.2026.5-r.3"},"tags":[{"name":"Alert Actions"}],"servers":[{"url":"/api"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","description":"The Bearer API key of your user <a href='/api-docs/#section/Authentication'>more info</a>.","name":"Authorization","in":"header"}}},"paths":{"/alert-actions/{id}":{"delete":{"tags":["Alert Actions"],"summary":"Remove a specific alert action.","parameters":[{"name":"id","in":"path","description":"entity ID","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Empty body delete response","content":{}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ilert.com/developer-docs/rest-api/api-reference/alert-actions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
