CrowdStrike UpdateHostTags
CertifiedEnterprise EditionAdd or remove tags on CrowdStrike Falcon hosts
CrowdStrike UpdateHostTags
Add or remove tags on CrowdStrike Falcon hosts
Adds and/or removes falcon-grouping tags on one or more hosts. At least one of tagsToAdd or tagsToRemove must be set; CrowdStrike applies each action in a separate call, so both can be used together in the same task run.
type: io.kestra.plugin.ee.crowdstrike.hosts.UpdateHostTagsExamples
Tag remediated hosts and remove the quarantine tag
id: update_host_tags
namespace: company.team
tasks:
- id: update_host_tags
type: io.kestra.plugin.ee.crowdstrike.hosts.UpdateHostTags
clientId: "{{ secret('CROWDSTRIKE_CLIENT_ID') }}"
clientSecret: "{{ secret('CROWDSTRIKE_CLIENT_SECRET') }}"
deviceIds:
- "f4a1c9e2b3d4e5f6a7b8c9d0e1f2a3b4"
tagsToAdd:
- "FalconGroupingTags/remediated"
tagsToRemove:
- "FalconGroupingTags/quarantine"
Properties
clientId *string
API client ID
Client ID of a CrowdStrike API client with the scopes required by the tasks and triggers being used.
clientSecret *string
API client secret
Client secret of the CrowdStrike API client. Exchanged for a short-lived OAuth2 Bearer token on every task run and trigger poll; never logged.
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150baseUrl string
https://api.crowdstrike.comCrowdStrike API base URL
Base URL of the CrowdStrike Falcon API for your cloud region (for example: https://api.crowdstrike.com for US-1, https://api.us-2.crowdstrike.com for US-2, https://api.eu-1.crowdstrike.com for EU-1, or https://api.laggar.gcw.crowdstrike.com for US-GOV-1). Defaults to the US-1 endpoint. Using the wrong region for your tenant results in 403 Forbidden responses.
deviceIds array
Device IDs
Device IDs of the hosts to update.
Outputs
affectedDeviceIds array
Device IDs CrowdStrike confirmed were updated
errorCount integer
Number of hosts CrowdStrike reported as failed
Populated when the API returns a 2xx response with partial per-host failures. See the task logs for the specific error messages.
