CrowdStrike UpdateHostTags

CrowdStrike UpdateHostTags
Certified
Enterprise Edition
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.

yaml
type: io.kestra.plugin.ee.crowdstrike.hosts.UpdateHostTags

Examples

Tag remediated hosts and remove the quarantine tag

yaml
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.

baseUrl string

Defaulthttps://api.crowdstrike.com

CrowdStrike 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.