v1

latestOpenAPI 3.1.02026-08-06330343826.1 KB

Asset Group

Asset Groups

Creates a new asset group. The searchCriteria field can be passed no matter what the type of the asset group is. The asset group type changes when the assets are refreshed. Dynamic asset groups constantly refreshed their membership as assets are scanned whereas static asset groups do not change membership automatically. See the <a href="#section/Responses/SearchCriteria">Search Criteria</a> for more information on using dynamic criteria.

post/api/3/asset_groups

Request body

assetsinteger

The number of assets that belong to the asset group.

descriptionstring

The description of the asset group.

idobject

The identifier of the asset group.

namestring required

The name of the asset group.

riskScorenumber double

The total risk score of all assets that belong to the asset group.

type'static' | 'dynamic' required

The type of the asset group.

Example request

{
  "assets": 768,
  "description": "Assets with unacceptable high risk required immediate remediation.",
  "links": [
    {
      "href": "https://hostname:3780/api/3/...",
      "rel": "self"
    }
  ],
  "name": "High Risk Assets",
  "riskScore": 4457823.78,
  "searchCriteria": {
    "match": "all"
  },
  "type": "dynamic",
  "vulnerabilities": {
    "critical": 16,
    "moderate": 3,
    "severe": 76,
    "total": 95
  }
}

Response

Created