Create Asset Group
POST {{cb_url}}/asset_groups/v1/orgs/{{cb_org_key}}/groups
Create a new asset group. Asset groups are used to categorize and manage assets (devices or endpoints) based on specific criteria, making it easier to apply policies and perform security operations. By using dynamic criteria in the “query” parameter, you can create asset groups that adapt and change dynamically as the conditions are met, ensuring that the group always contains relevant assets.
RBAC Permissions Required
| Permission (.notation name) | Operation(s) |
|---|---|
| group-management | CREATE |
Request Schema
{
"description": "<string>",
"member_type": "<string>",
"name": "<string>",
"query": "<string>",
"policy_id": <integer>
}
Request Body
{"description"=>"Test5", "member_type"=>"DEVICE", "name"=>"Test5", "query"=>"os_version:Windows", "policy_id"=>465946}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"id":"f2004957-abcd-abcd-921f-8dd70c9c1185","name":"Test5","description":"Test5","org_key":"abcd1234","status":"UPDATING","member_type":"DEVICE","discovered":false,"create_time":"2023-11-27T17:06:37.578Z","update_time":"2023-11-27T17:06:37.578Z","query":"os_version:Windows","member_count":0,"policy_id":465946,"policy_name":"Testing"}