CrowdStrike SearchHosts

CrowdStrike SearchHosts
Certified
Enterprise Edition
Search CrowdStrike Falcon host device IDs

Searches hosts with the CrowdStrike Falcon Query Language (FQL) and returns matching device IDs (AIDs), which can be passed to GetHost, ContainHost, LiftContainment, or UpdateHostTags. Omitting filter matches every host visible to the API client.

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

Examples

Search for Windows hosts that have not checked in for a while

yaml
id: search_stale_hosts
namespace: company.team

tasks:
  - id: search_hosts
    type: io.kestra.plugin.ee.crowdstrike.hosts.SearchHosts
    clientId: "{{ secret('CROWDSTRIKE_CLIENT_ID') }}"
    clientSecret: "{{ secret('CROWDSTRIKE_CLIENT_SECRET') }}"
    filter: "platform_name:'Windows'"
    sort: "last_seen.asc"
    limit: 100

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.