post
/public_api/v1/alerts/update_alerts
Update one or more alerts. You can update up to 100 alerts per request. Missing fields are ignored.
Required license: Cortex Xpanse Expander
CURL
curl -X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
"https://api-yourfqdn/public_api/v1/alerts/update_alerts" \
-d '{
"request_data" : {
"alert_id_list" : "alert_id_list",
"update_data" : {
"severity" : "severity",
"comment" : "comment",
"status" : "status"
}
}
}'
Response
{
"reply": {
"alerts_ids": [
104173820,
574203823,
395720183
]
}
}
Request
Body
optional
Example:
{"request_data":{"alert_id_list":"","update_data":{"severity":"low","status":"resolved_other","comment":"This alert is resolved"}}}
request_data
optional
(Required) A dictionary containing the API request fields.
An empty dictionary returns all results.
alert_id_list
optional
String
update_data
optional
severity
optional
String
Administrator-defined severity, one of the following:
- critical
- high
- medium
- low
- unknown
status
optional
String
Updated alert status, one of the following:
- resolved_-_no_longer_observed
- new
- resolved_-_no_risk
- resolved_-_risk_accepted
- under_investigation
- resolved_-_contested_asset
- resolved_-_remediated_automatically
- resolved
comment
optional
String
Descriptive comment explaining the alert change.
Responses