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