> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Perform Host Group Action

Perform the specified action on the Host Groups specified in the request. After creating a static host group, you must manually assign hosts to the group. You can also remove hosts that no longer belong in the group.

<Note>
  External Documentation

  To learn more, visit the [CrowdStrike documentation](https://falcon.us-2.crowdstrike.com/documentation/page/c0b16f1b/host-and-host-group-management-apis#o7a7769b).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter         | Description                                                                                                                                                                                                                                                                                                                                                                           |
  | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Action Name       | Specify one of these actions:<br /><br />- `add-hosts` - This action assigns hosts to the host groups.<br /><br />- `remove-hosts` - This action removes hosts to the host groups.                                                                                                                                                                                                    |
  | Action Parameters | A comma-separated list of the parameters for the prospective action.<br />Use the value parameter in the json of parameter "filter" to specify the host IDs to add or remove.<br />Example value:<br /><pre><code>\[\{ "name": "filter","value": "(device\_id:\['e139xxxxxxxx5885', '8393xxxxxxxx9650','389axxxxxxxx5e80'])" }, \{ "name": "name2", "value": "value2" }]</code></pre> |
  | Host Group IDs    | A comma-separated list of host group IDs to perform the action on. Can be obtained via the `List Host Groups` action.                                                                                                                                                                                                                                                                 |
</div>

## Example Output

```json theme={"dark"}
{
	"meta": {
		"query_time": 1.92e-7,
		"trace_id": "5b5f13b7-4bbf-4bbc-9273-827abe3ee465"
	},
	"errors": [],
	"resources": [
		{
			"id": "8015xxxxxxxx105d",
			"group_type": "static",
			"name": "Test Group 45",
			"description": "A demo group",
			"assignment_rule": "device_id:[],hostname:[]",
			"created_by": "api-client-id:2e6dxxxxxxxx4914",
			"created_timestamp": "2019-02-01T05:39:53.560719802Z",
			"modified_by": "api-client-id:2e6dxxxxxxxx4914",
			"modified_timestamp": "2019-02-01T05:39:53.560719802Z"
		}
	]
}
```

## Workflow Library Example

[Perform Host Group Action with Crowdstrike and Send Results Via Email](https://library.blinkops.com/workflows/perform-host-group-action-with-crowdstrike-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/perform-host-group-action-with-crowdstrike-and-send-results-via-email/canvas" />
</div>