Create an Alert

post

https://api.controlup.com/edge/api/alerts

Creates a new Alert.

Required permissions - View, Create, Edit and Delete Alerts

Body Params

name

string

required

Name of the alert.

description

string

Description of the alert.

severity

int32

required

Severity level of the alert.

1 - Informational
2 - Low
3 - Medium
4 - High
5 - Critical

enabled

boolean

Indicates if the alert is enabled.

platform

int32

required

OS platform. This determines which scripts are available to select as a followup action when the alert is triggered. This does not determine which devices can trigger the script.

0 - No platform selected
1 - Windows
2 - macOS
3 - Linux
4 - ChromeOS

results_threshold_seconds

int32

required

The length of time in seconds that the alert system searches back to check whether the alert's activation conditions were met.

results_threshold

int32

required

The number of times that the conditions must be met within the time window (results_threshold_seconds) for the trigger to activate.

retrigger_interval

int32

required

The minimum duration between subsequent alert activations. If the retrigger interval duration has not passed since the last alert activation, then the alert won't activate even if all conditions are met.

index

string

required

Index associated with the alert. The alerts conditions (located in `filters) must be based off of fields in the data index.

filters

array of objects

required

List of conditions for the alert to activate. Multiple conditions are combined using AND operators.

filters*

webhook_url

uri | null

URL for a webhook to be triggered.

script_id

string | null

ID of a system script to run on devices that trigger the alert. You can use GET /scripts to see script IDs.

user_script_id

string | null

ID of a user script to run on devices that trigger the alert. You can use GET /scripts to see script IDs.

survey_id

string | null

ID of an on-demand survey to run on devices that trigger the alert. You can use GET /surveys to see survey IDs.

email_addresses

string

A semicolon-separated list of email addresses to receive an email when the alert triggers.

servicenow_raise_incident

string

Indicates if the Alert raises a ServiceNow ticket when it activates. "true" means that a ticket is raised.

servicenow_ticket_type

int32

Type of ServiceNow ticket.

1 = Incident
2 = Event

servicenow_impact

int32

Impact level for the ServiceNow ticket.

1 = High
2 = Medium
3 = Low

servicenow_urgency

int32

Urgency level for the ServiceNow ticket.

1 = High
2 = Medium
3 = Low

servicenow_autoclose_interval

int32

Auto-close interval for the ServiceNow ticket in seconds.

Responses

200

Alert created.

401

Invalid or missing API key.

403

API key is expired.

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here!