Update Asset Group

PUT https://{{API_URL}}/asset_groups/{{id}}

Update a single asset group's attributes by ID. This will update the asset group's risk meter as well.

Request Params

KeyDatatypeRequiredDescription
**{{id}} above in url (or variable) to be updated with asset group ID found in Kenna Platformnull**Select asset group in Kenna Platform and get asset id from the URL
**All fields below are to updated in Body Params**nullAll fields below are to updated in Body Params
exclude_child_filter[]stringarray of strings - If you want to include all assets regardless of vulnerability filters, pass a value of ["Include all assets"]; otherwise, omit this parameter.
id[]stringarray of integers - Array of asset ids
min_prioritystringint32 - Search for all assets that have a priority greater than this value.
max_prioritystringint32 - Search for all assets that have a priority less than this value.
min_risk_meter_scorestringint32 - Search for all assets that have a risk meter score greater than this value.
operating_system[]stringarray of strings - An array of the names of the operating systems associated with a set of assets.
primary_locator[]stringarray of strings - The primary locator used for an asset. This should be one of the following values: ip_address, hostname, database, url, mac_address, netbios, fqdn, file, or application
qstringstring - This can be any query string you want to search for, including a regex. We also have our own search syntax that enables you to search assets based on specific locators and fields. For more detailed documentation on our search syntax visit our Help Center. Below is an example of our search syntax being used to find all assets with the hostname foobar. As stated in our Help Center, it is also possible to use our search syntax on vulnerability fields. In order to apply a query for a vulnerability field to an asset search you must nest the query string under a vulnerability key. The example below shows how to search for all assets that relate to vulnerabilities that are connected to the Heartbleed CVE.
service_ports[]stringarray of strings - An array of ports relating to your assets.
service_protocols[]stringarray of strings - An array of service protocols relating to your assets. Make sure all letters are lowercase.
status[]stringarray of strings - An array of statuses for your assets which can include active and/or inactive. NOTE: By default, only active assets are returned when searching. You must specify the asset status you want in order to override that default.
tags[]stringarray of strings - An array of tag names associated with your assets.
tag_boolean_modestringstring - Set this to 'all' if you would like to return assets that contain all of the tags in your query rather than assets that contain any of the tags. For example, if you want to return all assets the have the tag foo and the tag bar your request would look like this:
vulnerability: {id: []}stringarray of integers - Vulnerability ids. Search for all assets that have vulnerabilities with these ids.

Request Body

{"asset_group"=>{"name"=>"demotcg2"}}