Search for Asset Groups

POST {{cb_url}}/asset_groups/v1/orgs/{{cb_org_key}}/groups/_search

Search for Asset Groups that match specified criteria.

RBAC Permissions Required

Permission (.notation name)Operation(s)
group-managementREAD

See Documentation

Request Schema

{
  "start": <integer>,
  "rows": <integer>,
  "query": "<string>",
  "criteria": {
    "discovered": [<boolean>],
    "name": ["<string>"],
    "policy_id": [<integer>],
    "group_id": ["<string>"],
  },
  "sort": [
    {
      "field": "<string>",
      "order": "<string>"
    }
  ]
}

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;num_found&quot;:3,&quot;results&quot;:[{&quot;id&quot;:&quot;f2004957-ca49-4c77-921f-8dd70c9c1185&quot;,&quot;name&quot;:&quot;Test5&quot;,&quot;description&quot;:&quot;Test5&quot;,&quot;org_key&quot;:&quot;abcd1234&quot;,&quot;status&quot;:&quot;OK&quot;,&quot;member_type&quot;:&quot;DEVICE&quot;,&quot;discovered&quot;:false,&quot;create_time&quot;:&quot;2023-11-27T17:06:37.578Z&quot;,&quot;update_time&quot;:&quot;2023-11-27T17:06:38.226Z&quot;,&quot;query&quot;:&quot;os_version:Windows&quot;,&quot;member_count&quot;:21,&quot;policy_id&quot;:465946,&quot;policy_name&quot;:&quot;Pscr SE Testing&quot;},{&quot;id&quot;:&quot;5ba65b7b-843d-438a-9182-85f3c16a971a&quot;,&quot;name&quot;:&quot;Asset Group #1&quot;,&quot;org_key&quot;:&quot;abcd1234&quot;,&quot;status&quot;:&quot;OK&quot;,&quot;member_type&quot;:&quot;DEVICE&quot;,&quot;discovered&quot;:false,&quot;create_time&quot;:&quot;2023-09-20T16:29:32.186Z&quot;,&quot;update_time&quot;:&quot;2023-10-04T09:27:11.934Z&quot;,&quot;query&quot;:&quot;os.equals: \&quot;WINDOWS\&quot;&quot;,&quot;member_count&quot;:185,&quot;policy_id&quot;:465946,&quot;policy_name&quot;:&quot;Pscr SE Testing&quot;},{&quot;id&quot;:&quot;586f4f57-5cee-402f-9faf-0c98e0459cee&quot;,&quot;name&quot;:&quot;Limit test group 21&quot;,&quot;org_key&quot;:&quot;abcd1234&quot;,&quot;status&quot;:&quot;OK&quot;,&quot;member_type&quot;:&quot;DEVICE&quot;,&quot;discovered&quot;:false,&quot;create_time&quot;:&quot;2023-10-30T13:57:17.185Z&quot;,&quot;update_time&quot;:&quot;2023-11-15T16:50:29.317Z&quot;,&quot;query&quot;:&quot;last_internal_ip_address: 10.10.210.16\\/28&quot;,&quot;member_count&quot;:1,&quot;policy_id&quot;:465946,&quot;policy_name&quot;:&quot;Pscr SE Testing&quot;}]}