v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB

CSM Settings

Get agentless host facet info

Get the value distribution for a specific agentless host facet, with optional search and filtering.

get/api/v2/csm/settings/agentless_hosts/facet_info

Query parameters

facetstring required

Example:cloud_provider

The facet identifier to retrieve value distribution for. Valid values are resource_name, account_id, resource_type, cloud_provider, has_vulnerability_scanning, and has_posture_management.

searchstring

Example:aws

A search string to filter the facet values.

querystring

Example:cloud_provider:aws

A filter query to scope the facet value counts.

Response

Example response

{
  "data": {
    "attributes": {
      "items": [
        {
          "count": 100,
          "value": "aws"
        }
      ]
    },
    "id": "cloud_provider",
    "meta": {
      "total_count": 4
    },
    "type": "facet_info"
  }
}