post
/public_api/v1/featured_fields/replace_ip_addresses
Replace the featured IP addresses listed in your environment.
Note: Running this API will delete all existing IP addresses.
Required license: Cortex XDR Pro per Endpoint or Cortex XDR Pro per GB
CURL
curl -X POST \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
"https://api-yourfqdn/public_api/v1/featured_fields/replace_ip_addresses" \
-d '{
"request_data" : {
"fields" : [ {
"comment" : "comment",
"value" : "value"
}, {
"comment" : "comment",
"value" : "value"
} ]
}
}'
Request
Body
optional
Example:
{"request_data":{"fields":[{"value":"1.2.3.4","comment":"A single featured IP"},{"value":"192.111.1.0-192.111.1.255","comment":"Featured IP range"},{"value":"7.7.7.7/16","comment":"Featured CIDR"}]}}
request_data
required
fields
optional
Array
An array of IP addresses and comments.
value
required
String
Define the IP address. Maximum length is 256 characters, IP address can be a single IP address, range, or CIDR.
comment
optional
String
String that represents additional information regarding the featured IP address.
Responses
Successful response
Body
Bad Request. Got an invalid JSON.
Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
Example:
{"line": 1, "column": 19, "message": "no viable alternative at input '|alter2'"}
err_extra
optional
String
Additional information describing the error.
Unauthorized access. An issue occurred during authentication. This can indicate an incorrect key, id, or other invalid authentication parameters.
Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
Example:
{"line": 1, "column": 19, "message": "no viable alternative at input '|alter2'"}
err_extra
optional
String
Additional information describing the error.
Unauthorized access. User does not have the required license type to run this API.
Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
Example:
{"line": 1, "column": 19, "message": "no viable alternative at input '|alter2'"}
err_extra
optional
String
Additional information describing the error.
Forbidden access. The provided API Key does not have the required RBAC permissions to run this API.
Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
Example:
{"line": 1, "column": 19, "message": "no viable alternative at input '|alter2'"}
err_extra
optional
String
Additional information describing the error.
Internal server error. A unified status for API communication type errors.
Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
Example:
{"line": 1, "column": 19, "message": "no viable alternative at input '|alter2'"}
err_extra
optional
String
Additional information describing the error.