it_automation_task_groups

This data source provides information about IT Automation task groups in CrowdStrike Falcon. Task groups allow organizing tasks for RBAC and grouping purposes.

API Scopes

The following API scopes are required:

• IT Automation - Tasks: READ

Example Usage

terraform {
  required_providers {
    crowdstrike = {
      source = "registry.terraform.io/crowdstrike/crowdstrike"
    }
  }
}

provider "crowdstrike" {
  cloud = "us-2"
}

# Get all task groups
data "crowdstrike_it_automation_task_groups" "all" {}

# Look up task groups by name (translated to FQL)
data "crowdstrike_it_automation_task_groups" "security_scans" {
  name = "Security Scans"
}

# Look up task groups by access type
data "crowdstrike_it_automation_task_groups" "public_groups" {
  access_type = "Public"
}

# Look up specific task groups by IDs
data "crowdstrike_it_automation_task_groups" "specific" {
  ids = ["a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"]
}

# Use FQL filter for advanced queries
data "crowdstrike_it_automation_task_groups" "recent" {
  filter = "created_time:>='2025-01-01T00:00:00Z'"
  sort   = "name|asc"
}

Schema

Optional

• access_type (String) Filter task groups by access type. Translated to FQL. Cannot be used together with filter or ids.
• filter (String) FQL filter to apply to the task groups query. Cannot be used together with ids or individual filter attributes. Allowed filter fields: access_type, created_by, created_time, modified_by, modified_time, name.
• ids (List of String) List of task group IDs to retrieve. Cannot be used together with filter or individual filter attributes.
• name (String) Filter task groups by name. Translated to FQL. Cannot be used together with filter or ids.
• sort (String) Sort expression for results. Allowed sort fields: access_type, created_by, created_time, modified_by, modified_time, name. Append |asc or |desc for direction. Example: name|asc.

Read-Only

• task_groups (Attributes List) The list of IT Automation task groups. (see below for nested schema)

Nested Schema for task_groups

Read-Only:

• access_type (String) Access type of the task group (Public, Shared, Private).
• assigned_user_group_ids (List of String) Assigned user group IDs of the group.
• assigned_user_ids (List of String) Assigned user IDs of the group.
• created_by (String) User who created the task group.
• created_time (String) Timestamp when the task group was created.
• description (String) Description of the task group.
• id (String) Identifier for the task group.
• is_preset (Boolean) Whether this is a preset task group.
• modified_by (String) User who last modified the task group.
• modified_time (String) Timestamp when the task group was last modified.
• name (String) Name of the task group.
• supported_os (List of String) List of supported operating systems.
• task_ids (List of String) List of task IDs in the group.