---
title: "Asset Group"
method: PUT
path: "/api/3/asset_groups/{id}"
tags: ["Asset Group"]
---

# Asset Group

`PUT /api/3/asset_groups/{id}`

Updates the details of an asset group. See the search criteria endpoint (/search_criteria) for more information about building the search criteria and examples.

## Path parameters

- `id` integer, required — The identifier of the asset group.

## Request body

- AssetGroup — The details of the asset group.
  - `assets` integer — The number of assets that belong to the asset group.
  - `description` string — The description of the asset group.
  - `id` object — The identifier of the asset group.
  - `links` Link[], required — Hypermedia links to corresponding or related resources.
    - `deprecation` string
    - `href` string — A hypertext reference, which is either a URI (see <a target="_blank" rel="noopener noreferrer" href="https://tools.ietf.org/html/rfc3986">RFC 3986</a>) or URI template (see <a target="_blank" rel="noopener noreferrer" href="https://tools.ietf.org/html/rfc6570">RFC 6570</a>).
    - `hreflang` string
    - `media` string
    - `rel` string — The link relation type. This value is one from the <a target="_blank" rel="noopener noreferrer" href="https://tools.ietf.org/html/rfc5988#section-6.2">Link Relation Type Registry</a> or is the type of resource being linked to.
    - `title` string
    - `type` string
  - `name` string, required — The name of the asset group.
  - `riskScore` number, double — The total risk score of all assets that belong to the asset group.
  - `searchCriteria` SearchCriteria — The search criteria specification.
    - `filters` SwaggerSearchCriteriaFilter[] — Filters used to match assets. See <a href="#section/Responses/SearchCriteria">Search Criteria</a> for more information on the structure and format.
      - `field` string — The filter field for the search criteria.
      - `lower` object — The lower value to match in a range criteria.
      - `operator` string — The operator on how to match the search criteria.
      - `upper` object — The upper value to match in a range criteria.
      - `value` object — The single value to match using the operator.
      - `values` object[] — An array of values to match using the operator.
    - `match` 'any' | 'all' — Operator to determine how to match filters. `all` requires that all filters match for an asset to be included. `any` requires only one filter to match for an asset to be included.
  - `type` 'static' | 'dynamic', required — The type of the asset group.
  - `vulnerabilities` Vulnerabilities — Summary information for distinct vulnerabilities found on the assets.
    - `critical` integer — The number of critical vulnerabilities.
    - `moderate` integer — The number of moderate vulnerabilities.
    - `severe` integer — The number of severe vulnerabilities.
    - `total` integer — The total number of vulnerabilities.

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/rapid7/apis/rapid7-vm-api.md) · [All operations](https://skmtc.net/rapid7/apis/rapid7-vm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rapid7/rapid7-vm-api/versions/3a8197c22d71/schema)