Skip to main content

CrowdStrike Platform Integration Guide

Overview

The CrowdStrike Platform integration allows your NINA workflows to connect with CrowdStrike Falcon platform for core platform services, administration, automation, and integrations. This integration enables automated security operations, threat detection, and incident response directly from your automation platform.

Capabilities

This integration provides access to 25 resources with 319 operations covering:

  • Api Integrations: Operations for Api Integrations
  • Case Files: Operations for Case Files
  • Case Management: Operations for Case Management
  • Cases: Operations for Cases
  • Custom Storage: Operations for Custom Storage
  • Data Protection Configuration: Operations for Data Protection Configuration
  • Delivery Settings: Operations for Delivery Settings
  • Deployments: Operations for Deployments
  • Downloads Api: Operations for Downloads Api
  • Event Streams: Operations for Event Streams
  • Execution: Operations for Execution
  • Falcon Complete Dashboard: Operations for Falcon Complete Dashboard
  • Foundry Logscale: Operations for Foundry Logscale
  • It Automation: Operations for It Automation
  • Lookup Files: Operations for Lookup Files
  • Message Center: Operations for Message Center
  • Mssp: Operations for Mssp
  • Ngsiem: Operations for Ngsiem
  • Release Notes: Operations for Release Notes
  • Releases: Operations for Releases
  • Report Executions: Operations for Report Executions
  • Scheduled Reports: Operations for Scheduled Reports
  • Sensor Usage Api: Operations for Sensor Usage Api
  • User Management: Operations for User Management
  • Workflows: Operations for Workflows

Credential Configuration

Before using the CrowdStrike Platform integration in your workflows, you need to configure credentials for authentication.

Authentication Method

CrowdStrike Falcon uses OAuth2 Client Credentials authentication. This is a server-to-server authentication flow where you provide a Client ID and Client Secret, and the integration automatically handles token acquisition and refresh.

FieldDescriptionRequired
Client IDYour CrowdStrike API Client IDYes
Client SecretYour CrowdStrike API Client SecretYes
Base URLCrowdStrike API endpoint for your cloud regionYes

How It Works

  1. You provide the Client ID and Client Secret when creating a credential
  2. The integration exchanges these for an OAuth2 access token automatically
  3. Tokens are refreshed automatically when they expire
  4. No redirect URLs or user interaction required

CrowdStrike Cloud Regions

Select the Base URL that matches your CrowdStrike Falcon cloud region:

Cloud RegionBase URLDescription
US-1https://api.crowdstrike.comUnited States (default)
US-2https://api.us-2.crowdstrike.comUnited States (secondary)
EU-1https://api.eu-1.crowdstrike.comEuropean Union
US-GOV-1https://api.laggar.gcw.crowdstrike.comUS Government Cloud

How to Obtain API Credentials

  1. Log in to the CrowdStrike Falcon Console
  2. Navigate to Support and resources > API Clients and Keys
  3. Click Add new API client
  4. Configure the API client:
    • Client Name: A descriptive name (e.g., "NINA Integration")
    • Description: Purpose of this API client
    • API Scopes: Select the permissions required for your use case (see Required Scopes below)
  5. Click Add to create the client
  6. Copy and securely store the Client ID and Client Secret immediately

Important: The Client Secret is only displayed once at creation time. If you lose it, you must create a new API client.

Required API Scopes

The API scopes required depend on which operations you plan to use. Common scopes include:

ScopePermissionUse Case
DetectionsRead/WriteView and manage detections
HostsRead/WriteQuery and manage endpoints
IncidentsRead/WriteView and manage incidents
IOCsRead/WriteManage indicators of compromise
Prevention PoliciesRead/WriteManage prevention policies
Real Time ResponseRead/WriteExecute RTR commands
Sensor Update PoliciesRead/WriteManage sensor updates

Refer to the CrowdStrike API documentation for a complete list of available scopes.

Creating a CrowdStrike Credential in NINA

  1. Navigate to the Credentials section in NINA
  2. Click Add New Credential
  3. Fill in the credential details:
    • Integration Service: Select "CrowdStrike Platform"
    • Client ID: Paste your CrowdStrike API Client ID
    • Client Secret: Paste your CrowdStrike API Client Secret
    • Base URL: Select your CrowdStrike cloud region URL
  4. Click Test Connection to verify the credentials work
  5. Click Save to store the credential securely

Note: All CrowdStrike integrations (EDR, Intel, Platform, etc.) share the same credential. You only need to create one credential to use across all CrowdStrike modules.

Supported Resources

ResourceDescriptionOperations
Api IntegrationsOperations for Api Integrations3
Case FilesOperations for Case Files10
Case ManagementOperations for Case Management30
CasesOperations for Cases8
Custom StorageOperations for Custom Storage18
Data Protection ConfigurationOperations for Data Protection Configuration36
Delivery SettingsOperations for Delivery Settings2
DeploymentsOperations for Deployments1
Downloads ApiOperations for Downloads Api3
Event StreamsOperations for Event Streams2
ExecutionOperations for Execution1
Falcon Complete DashboardOperations for Falcon Complete Dashboard21
Foundry LogscaleOperations for Foundry Logscale14
It AutomationOperations for It Automation42
Lookup FilesOperations for Lookup Files2
Message CenterOperations for Message Center9
MsspOperations for Mssp30
NgsiemOperations for Ngsiem29
Release NotesOperations for Release Notes4
ReleasesOperations for Releases1
Report ExecutionsOperations for Report Executions4
Scheduled ReportsOperations for Scheduled Reports3
Sensor Usage ApiOperations for Sensor Usage Api2
User ManagementOperations for User Management25
WorkflowsOperations for Workflows19

Resource Details

Api Integrations

Operations for Api Integrations

Operations

OperationNameDescription
execute_commandExecute CommandSDK: api_integrations.ExecuteCommand
execute_command_proxyExecute Command ProxySDK: api_integrations.ExecuteCommandProxy
get_combined_plugin_configsGet Combined Plugin ConfigsSDK: api_integrations.GetCombinedPluginConfigs

Execute Command

SDK: api_integrations.ExecuteCommand

Parameters:

NameTypeRequiredDescription
resourcesarrayYesBatch operation - array of JSON strings. Each item should be: {"field1":"value1","field2":"value...

Example:

{
"resources": ["<resources>"]
}

Execute Command Proxy

SDK: api_integrations.ExecuteCommandProxy

Parameters:

NameTypeRequiredDescription
resourcesarrayYesBatch operation - array of JSON strings. Each item should be: {"field1":"value1","field2":"value...

Example:

{
"resources": ["<resources>"]
}

Get Combined Plugin Configs

SDK: api_integrations.GetCombinedPluginConfigs

Parameters:

NameTypeRequiredDescription
filterstringNoFilter items using a query in Falcon Query Language (FQL).
limitnumberNoThe number of items to return in this response (default: 100, max: 500). Use with the offset para...
offsetnumberNoThe first item to return, where 0 is the latest item. Use with the limit parameter to manage pagi...
sortstringNoSort items using their properties.

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Case Files

Operations for Case Files

Operations

OperationNameDescription
aggregates_file_details_post_Aggregates File Details PostSDK: case_files.AggregatesFileDetailsPostV1
combined_file_details_get_Combined File Details GetSDK: case_files.CombinedFileDetailsGetV1
entities_file_details_get_Entities File Details GetSDK: case_files.EntitiesFileDetailsGetV1
entities_file_details_patch_Entities File Details PatchSDK: case_files.EntitiesFileDetailsPatchV1
entities_files_bulk_download_post_Entities Files Bulk Download PostSDK: case_files.EntitiesFilesBulkDownloadPostV1
entities_files_delete_Entities Files DeleteSDK: case_files.EntitiesFilesDeleteV1
entities_files_download_get_Entities Files Download GetSDK: case_files.EntitiesFilesDownloadGetV1
entities_files_download_post_Entities Files Download PostSDK: case_files.EntitiesFilesDownloadPostV1
entities_files_upload_post_Entities Files Upload PostSDK: case_files.EntitiesFilesUploadPostV1
queries_file_details_get_Queries File Details GetSDK: case_files.QueriesFileDetailsGetV1

Aggregates File Details Post

SDK: case_files.AggregatesFileDetailsPostV1

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
filterstringNoFQL filter expression
idsarrayNoResource IDs

Example:

{
"body": {},
"filter": "<filter>",
"ids": ["<ids>"]
}

Combined File Details Get

SDK: case_files.CombinedFileDetailsGetV1

Parameters:

NameTypeRequiredDescription
filterstringNoFQL filter expression
limitnumberNoPage size
offsetnumberNoPage offset

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10
}

Entities File Details Get

SDK: case_files.EntitiesFileDetailsGetV1

Parameters:

NameTypeRequiredDescription
idsarrayNoResource IDs

Example:

{
"ids": ["<ids>"]
}

Entities File Details Patch

SDK: case_files.EntitiesFileDetailsPatchV1

Parameters:

NameTypeRequiredDescription
descriptionstringYesdescription. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
idstringYes

Example:

{
"description": "<description>",
"id": "<id>"
}

Entities Files Bulk Download Post

SDK: case_files.EntitiesFilesBulkDownloadPostV1

Parameters:

NameTypeRequiredDescription
idsarrayYesids. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"ids": ["<ids>"]
}

Entities Files Delete

SDK: case_files.EntitiesFilesDeleteV1

Parameters:

NameTypeRequiredDescription
idsarrayNoResource IDs

Example:

{
"ids": ["<ids>"]
}

Entities Files Download Get

SDK: case_files.EntitiesFilesDownloadGetV1

Parameters:

NameTypeRequiredDescription
idstringNoResource ID

Example:

{
"id": "<id>"
}

Entities Files Download Post

SDK: case_files.EntitiesFilesDownloadPostV1

Parameters:

NameTypeRequiredDescription
idsarrayYesids. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"ids": ["<ids>"]
}

Entities Files Upload Post

SDK: case_files.EntitiesFilesUploadPostV1

This operation has no parameters.

Example:

{
}

Queries File Details Get

SDK: case_files.QueriesFileDetailsGetV1

Parameters:

NameTypeRequiredDescription
filterstringNoFQL filter expression
limitnumberNoPage size
offsetnumberNoPage offset

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10
}

Case Management

Operations for Case Management

Operations

OperationNameDescription
aggregates_notification_groups_post_Aggregates Notification Groups PostSDK: case_management.AggregatesNotificationGroupsPostV1
aggregates_notification_groups_post_v2Aggregates Notification Groups Post V2SDK: case_management.AggregatesNotificationGroupsPostV2
aggregates_slas_post_Aggregates Slas PostSDK: case_management.AggregatesSlasPostV1
aggregates_templates_post_Aggregates Templates PostSDK: case_management.AggregatesTemplatesPostV1
entities_fields_get_Entities Fields GetSDK: case_management.EntitiesFieldsGetV1
entities_notification_groups_delete_Entities Notification Groups DeleteSDK: case_management.EntitiesNotificationGroupsDeleteV1
entities_notification_groups_delete_v2Entities Notification Groups Delete V2SDK: case_management.EntitiesNotificationGroupsDeleteV2
entities_notification_groups_get_Entities Notification Groups GetSDK: case_management.EntitiesNotificationGroupsGetV1
entities_notification_groups_get_v2Entities Notification Groups Get V2SDK: case_management.EntitiesNotificationGroupsGetV2
entities_notification_groups_patch_Entities Notification Groups PatchSDK: case_management.EntitiesNotificationGroupsPatchV1
entities_notification_groups_patch_v2Entities Notification Groups Patch V2SDK: case_management.EntitiesNotificationGroupsPatchV2
entities_notification_groups_post_Entities Notification Groups PostSDK: case_management.EntitiesNotificationGroupsPostV1
entities_notification_groups_post_v2Entities Notification Groups Post V2SDK: case_management.EntitiesNotificationGroupsPostV2
entities_slas_delete_Entities Slas DeleteSDK: case_management.EntitiesSlasDeleteV1
entities_slas_get_Entities Slas GetSDK: case_management.EntitiesSlasGetV1
entities_slas_patch_Entities Slas PatchSDK: case_management.EntitiesSlasPatchV1
entities_slas_post_Entities Slas PostSDK: case_management.EntitiesSlasPostV1
entities_template_snapshots_get_Entities Template Snapshots GetSDK: case_management.EntitiesTemplateSnapshotsGetV1
entities_templates_delete_Entities Templates DeleteSDK: case_management.EntitiesTemplatesDeleteV1
entities_templates_export_get_Entities Templates Export GetSDK: case_management.EntitiesTemplatesExportGetV1
entities_templates_get_Entities Templates GetSDK: case_management.EntitiesTemplatesGetV1
entities_templates_import_post_Entities Templates Import PostSDK: case_management.EntitiesTemplatesImportPostV1
entities_templates_patch_Entities Templates PatchSDK: case_management.EntitiesTemplatesPatchV1
entities_templates_post_Entities Templates PostSDK: case_management.EntitiesTemplatesPostV1
queries_fields_get_Queries Fields GetSDK: case_management.QueriesFieldsGetV1
queries_notification_groups_get_Queries Notification Groups GetSDK: case_management.QueriesNotificationGroupsGetV1
queries_notification_groups_get_v2Queries Notification Groups Get V2SDK: case_management.QueriesNotificationGroupsGetV2
queries_slas_get_Queries Slas GetSDK: case_management.QueriesSlasGetV1
queries_template_snapshots_get_Queries Template Snapshots GetSDK: case_management.QueriesTemplateSnapshotsGetV1
queries_templates_get_Queries Templates GetSDK: case_management.QueriesTemplatesGetV1

Aggregates Notification Groups Post

SDK: case_management.AggregatesNotificationGroupsPostV1

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Aggregates Notification Groups Post V2

SDK: case_management.AggregatesNotificationGroupsPostV2

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Aggregates Slas Post

SDK: case_management.AggregatesSlasPostV1

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Aggregates Templates Post

SDK: case_management.AggregatesTemplatesPostV1

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Entities Fields Get

SDK: case_management.EntitiesFieldsGetV1

Parameters:

NameTypeRequiredDescription
idsarrayNoResource IDs

Example:

{
"ids": ["<ids>"]
}

Entities Notification Groups Delete

SDK: case_management.EntitiesNotificationGroupsDeleteV1

Parameters:

NameTypeRequiredDescription
idsarrayNoResource IDs

Example:

{
"ids": ["<ids>"]
}

Entities Notification Groups Delete V2

SDK: case_management.EntitiesNotificationGroupsDeleteV2

Parameters:

NameTypeRequiredDescription
idsarrayNoResource IDs

Example:

{
"ids": ["<ids>"]
}

Entities Notification Groups Get

SDK: case_management.EntitiesNotificationGroupsGetV1

Parameters:

NameTypeRequiredDescription
idsarrayNoResource IDs

Example:

{
"ids": ["<ids>"]
}

Entities Notification Groups Get V2

SDK: case_management.EntitiesNotificationGroupsGetV2

Parameters:

NameTypeRequiredDescription
idsarrayNoResource IDs

Example:

{
"ids": ["<ids>"]
}

Entities Notification Groups Patch

SDK: case_management.EntitiesNotificationGroupsPatchV1

Parameters:

NameTypeRequiredDescription
channelsobjectYeschannels. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
descriptionstringYesdescription. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
idstringYes
namestringYesname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"channels": {},
"description": "<description>",
"id": "<id>",
"name": "<name>"
}

Entities Notification Groups Patch V2

SDK: case_management.EntitiesNotificationGroupsPatchV2

Parameters:

NameTypeRequiredDescription
channelsobjectYeschannels. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
descriptionstringYesdescription. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
idstringYes
namestringYesname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"channels": {},
"description": "<description>",
"id": "<id>",
"name": "<name>"
}

Entities Notification Groups Post

SDK: case_management.EntitiesNotificationGroupsPostV1

Parameters:

NameTypeRequiredDescription
channelsobjectYeschannels. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
descriptionstringYesdescription. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
namestringYesname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"channels": {},
"description": "<description>",
"name": "<name>"
}

Entities Notification Groups Post V2

SDK: case_management.EntitiesNotificationGroupsPostV2

Parameters:

NameTypeRequiredDescription
channelsobjectYeschannels. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
descriptionstringYesdescription. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
namestringYesname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"channels": {},
"description": "<description>",
"name": "<name>"
}

Entities Slas Delete

SDK: case_management.EntitiesSlasDeleteV1

Parameters:

NameTypeRequiredDescription
idsarrayNoResource IDs

Example:

{
"ids": ["<ids>"]
}

Entities Slas Get

SDK: case_management.EntitiesSlasGetV1

Parameters:

NameTypeRequiredDescription
idsarrayNoResource IDs

Example:

{
"ids": ["<ids>"]
}

Entities Slas Patch

SDK: case_management.EntitiesSlasPatchV1

Parameters:

NameTypeRequiredDescription
descriptionstringYesdescription. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
goalsobjectYesgoals. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
idstringYes
namestringYesname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"description": "<description>",
"goals": {},
"id": "<id>",
"name": "<name>"
}

Entities Slas Post

SDK: case_management.EntitiesSlasPostV1

Parameters:

NameTypeRequiredDescription
descriptionstringYesdescription. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
goalsobjectYesgoals. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
namestringYesname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"description": "<description>",
"goals": {},
"name": "<name>"
}

Entities Template Snapshots Get

SDK: case_management.EntitiesTemplateSnapshotsGetV1

Parameters:

NameTypeRequiredDescription
idsarrayNoSnapshot IDs
template_idsarrayNoRetrieves the latest snapshot for all Template IDs
versionsarrayNoRetrieve a specific version of the template from the parallel array template_ids. A value of ze...

Example:

{
"ids": ["<ids>"],
"template_ids": ["<template_ids>"],
"versions": ["<versions>"]
}

Entities Templates Delete

SDK: case_management.EntitiesTemplatesDeleteV1

Parameters:

NameTypeRequiredDescription
idsarrayNoResource IDs

Example:

{
"ids": ["<ids>"]
}

Entities Templates Export Get

SDK: case_management.EntitiesTemplatesExportGetV1

Parameters:

NameTypeRequiredDescription
filterstringNoFQL filter expression
formatstringNoExport file format Default: "yaml"
idsarrayNoTemplate IDs

Example:

{
"filter": "<filter>",
"format": "<format>",
"ids": ["<ids>"]
}

Entities Templates Get

SDK: case_management.EntitiesTemplatesGetV1

Parameters:

NameTypeRequiredDescription
idsarrayNoResource IDs

Example:

{
"ids": ["<ids>"]
}

Entities Templates Import Post

SDK: case_management.EntitiesTemplatesImportPostV1

Parameters:

NameTypeRequiredDescription
dry_runbooleanNoRun validation only

Example:

{
"dry_run": true
}

Entities Templates Patch

SDK: case_management.EntitiesTemplatesPatchV1

Parameters:

NameTypeRequiredDescription
descriptionstringNodescription. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
fieldsobjectYesfields. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
idstringYes
namestringYesname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
sla_idstringNosla id. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"description": "<description>",
"fields": {},
"id": "<id>",
"name": "<name>",
"sla_id": "<sla_id>"
}

Entities Templates Post

SDK: case_management.EntitiesTemplatesPostV1

Parameters:

NameTypeRequiredDescription
descriptionstringNodescription. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
fieldsobjectYesfields. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
namestringYesname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
sla_idstringNosla id. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"description": "<description>",
"fields": {},
"name": "<name>",
"sla_id": "<sla_id>"
}

Queries Fields Get

SDK: case_management.QueriesFieldsGetV1

Parameters:

NameTypeRequiredDescription
filterstringNoFQL filter expression
limitnumberNoPage size
offsetnumberNoPage offset

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10
}

Queries Notification Groups Get

SDK: case_management.QueriesNotificationGroupsGetV1

Parameters:

NameTypeRequiredDescription
filterstringNoFQL filter expression
limitnumberNoPage size
offsetnumberNoPage offset
sortstringNoSort expression. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Queries Notification Groups Get V2

SDK: case_management.QueriesNotificationGroupsGetV2

Parameters:

NameTypeRequiredDescription
filterstringNoFQL filter expression
limitnumberNoPage size
offsetnumberNoPage offset
sortstringNoSort expression. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Queries Slas Get

SDK: case_management.QueriesSlasGetV1

Parameters:

NameTypeRequiredDescription
filterstringNoFQL filter expression
limitnumberNoPage size
offsetnumberNoPage offset
sortstringNoSort expression. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Queries Template Snapshots Get

SDK: case_management.QueriesTemplateSnapshotsGetV1

Parameters:

NameTypeRequiredDescription
filterstringNoFQL filter expression
limitnumberNoPage size
offsetnumberNoPage offset

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10
}

Queries Templates Get

SDK: case_management.QueriesTemplatesGetV1

Parameters:

NameTypeRequiredDescription
filterstringNoFQL filter expression
limitnumberNoPage size
offsetnumberNoPage offset
sortstringNoSort expression. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Cases

Operations for Cases

Operations

OperationNameDescription
entities_alert_evidence_post_Entities Alert Evidence PostSDK: cases.EntitiesAlertEvidencePostV1
entities_case_tags_delete_Entities Case Tags DeleteSDK: cases.EntitiesCaseTagsDeleteV1
entities_case_tags_post_Entities Case Tags PostSDK: cases.EntitiesCaseTagsPostV1
entities_cases_patch_v2Entities Cases Patch V2SDK: cases.EntitiesCasesPatchV2
entities_cases_post_v2Entities Cases Post V2SDK: cases.EntitiesCasesPostV2
entities_cases_put_v2Entities Cases Put V2SDK: cases.EntitiesCasesPutV2
entities_event_evidence_post_Entities Event Evidence PostSDK: cases.EntitiesEventEvidencePostV1
queries_cases_get_Queries Cases GetSDK: cases.QueriesCasesGetV1

Entities Alert Evidence Post

SDK: cases.EntitiesAlertEvidencePostV1

Parameters:

NameTypeRequiredDescription
alertsobjectYesalerts. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
idstringYes

Example:

{
"alerts": {},
"id": "<id>"
}

Entities Case Tags Delete

SDK: cases.EntitiesCaseTagsDeleteV1

Parameters:

NameTypeRequiredDescription
idstringNoThe ID of the case to remove tags from.
tagarrayNoThe tag to remove from the case.

Example:

{
"id": "<id>",
"tag": ["<tag>"]
}

Entities Case Tags Post

SDK: cases.EntitiesCaseTagsPostV1

Parameters:

NameTypeRequiredDescription
idstringYes
tagsarrayYestags. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"id": "<id>",
"tags": ["<tags>"]
}

Entities Cases Patch V2

SDK: cases.EntitiesCasesPatchV2

Parameters:

NameTypeRequiredDescription
expected_consistency_versionnumberNoexpected consistency version
expected_versionnumberNoexpected version. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
fieldsobjectYesfields. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
idstringYes

Example:

{
"expected_consistency_version": 10,
"expected_version": 10,
"fields": {},
"id": "<id>"
}

Entities Cases Post V2

SDK: cases.EntitiesCasesPostV2

Parameters:

NameTypeRequiredDescription
idsarrayYesids. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"ids": ["<ids>"]
}

Entities Cases Put V2

SDK: cases.EntitiesCasesPutV2

Parameters:

NameTypeRequiredDescription
assigned_to_user_uuidstringYesassigned to user uuid
descriptionstringYesdescription. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
evidenceobjectYesevidence. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
namestringYesname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
severitynumberYesseverity. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
statusstringYesstatus. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
tagsarrayYestags. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
templateobjectNotemplate. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"assigned_to_user_uuid": "<assigned_to_user_uuid>",
"description": "<description>",
"evidence": {},
"name": "<name>",
"severity": 10,
"status": "<status>",
"tags": ["<tags>"],
"template": {}
}

Entities Event Evidence Post

SDK: cases.EntitiesEventEvidencePostV1

Parameters:

NameTypeRequiredDescription
eventsobjectYesevents. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
idstringYes

Example:

{
"events": {},
"id": "<id>"
}

Queries Cases Get

SDK: cases.QueriesCasesGetV1

Parameters:

NameTypeRequiredDescription
filterstringNoFilter Cases using a query in Falcon Query Language (FQL).Filter fields can be any keyword field ...
limitnumberNoThe maximum number of Cases to return in this response (default: 100; max: 10000). Use this param...
offsetnumberNoThe first case to return, where 0 is the latest case. Use with the offset parameter to manage...
sortstringNoSort parameter takes the form <field

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Custom Storage

Operations for Custom Storage

Operations

OperationNameDescription
delete_objectDelete ObjectSDK: custom_storage.DeleteObject
delete_versioned_objectDelete Versioned ObjectSDK: custom_storage.DeleteVersionedObject
describe_collectionDescribe CollectionSDK: custom_storage.DescribeCollection
describe_collectionsDescribe CollectionsSDK: custom_storage.DescribeCollections
get_objectGet ObjectSDK: custom_storage.GetObject
get_object_metadataGet Object MetadataSDK: custom_storage.GetObjectMetadata
get_schemaGet SchemaSDK: custom_storage.GetSchema
get_schema_metadataGet Schema MetadataSDK: custom_storage.GetSchemaMetadata
get_versioned_objectGet Versioned ObjectSDK: custom_storage.GetVersionedObject
get_versioned_object_metadataGet Versioned Object MetadataSDK: custom_storage.GetVersionedObjectMetadata
list_collectionsList CollectionsSDK: custom_storage.ListCollections
list_objectsList ObjectsSDK: custom_storage.ListObjects
list_objects_by_versionList Objects By VersionSDK: custom_storage.ListObjectsByVersion
list_schemasList SchemasSDK: custom_storage.ListSchemas
put_objectPut ObjectSDK: custom_storage.PutObject
put_object_by_versionPut Object By VersionSDK: custom_storage.PutObjectByVersion
search_objectsSearch ObjectsSDK: custom_storage.SearchObjects
search_objects_by_versionSearch Objects By VersionSDK: custom_storage.SearchObjectsByVersion

Delete Object

SDK: custom_storage.DeleteObject

Parameters:

NameTypeRequiredDescription
collection_namestringNoThe name of the collection
dry_runbooleanNoIf false, run the operation as normal. If true, validate that the request would succeed, but do...
object_keystringNoThe object key

Example:

{
"collection_name": "<collection_name>",
"dry_run": true,
"object_key": "<object_key>"
}

Delete Versioned Object

SDK: custom_storage.DeleteVersionedObject

Parameters:

NameTypeRequiredDescription
collection_namestringNoThe name of the collection
collection_versionstringNoThe version of the collection
dry_runbooleanNoIf false, run the operation as normal. If true, validate that the request would succeed, but do...
object_keystringNoThe object key

Example:

{
"collection_name": "<collection_name>",
"collection_version": "<collection_version>",
"dry_run": true,
"object_key": "<object_key>"
}

Describe Collection

SDK: custom_storage.DescribeCollection

Parameters:

NameTypeRequiredDescription
collection_namestringNoThe name of the collection

Example:

{
"collection_name": "<collection_name>"
}

Describe Collections

SDK: custom_storage.DescribeCollections

Parameters:

NameTypeRequiredDescription
namesarrayNoA set of collection names

Example:

{
"names": ["<names>"]
}

Get Object

SDK: custom_storage.GetObject

Parameters:

NameTypeRequiredDescription
collection_namestringNoThe name of the collection
object_keystringNoThe object key

Example:

{
"collection_name": "<collection_name>",
"object_key": "<object_key>"
}

Get Object Metadata

SDK: custom_storage.GetObjectMetadata

Parameters:

NameTypeRequiredDescription
collection_namestringNoThe name of the collection
object_keystringNoThe object key

Example:

{
"collection_name": "<collection_name>",
"object_key": "<object_key>"
}

Get Schema

SDK: custom_storage.GetSchema

Parameters:

NameTypeRequiredDescription
collection_namestringNoThe name of the collection
schema_versionstringNoThe version of the collection schema or 'latest' for the latest version

Example:

{
"collection_name": "<collection_name>",
"schema_version": "<schema_version>"
}

Get Schema Metadata

SDK: custom_storage.GetSchemaMetadata

Parameters:

NameTypeRequiredDescription
collection_namestringNoThe name of the collection
schema_versionstringNoThe version of the collection schema or 'latest' for the latest version

Example:

{
"collection_name": "<collection_name>",
"schema_version": "<schema_version>"
}

Get Versioned Object

SDK: custom_storage.GetVersionedObject

Parameters:

NameTypeRequiredDescription
collection_namestringNoThe name of the collection
collection_versionstringNoThe version of the collection
object_keystringNoThe object key

Example:

{
"collection_name": "<collection_name>",
"collection_version": "<collection_version>",
"object_key": "<object_key>"
}

Get Versioned Object Metadata

SDK: custom_storage.GetVersionedObjectMetadata

Parameters:

NameTypeRequiredDescription
collection_namestringNoThe name of the collection
collection_versionstringNoThe version of the collection
object_keystringNoThe object key

Example:

{
"collection_name": "<collection_name>",
"collection_version": "<collection_version>",
"object_key": "<object_key>"
}

List Collections

SDK: custom_storage.ListCollections

Parameters:

NameTypeRequiredDescription
endstringNoThe end key to end listing to
limitnumberNoThe limit of results to return
startstringNoThe start key to start listing from

Example:

{
"end": "<end>",
"limit": 10,
"start": "<start>"
}

List Objects

SDK: custom_storage.ListObjects

Parameters:

NameTypeRequiredDescription
collection_namestringNoThe name of the collection
endstringNoThe end key to end listing to
limitnumberNoThe limit of results to return
startstringNoThe start key to start listing from

Example:

{
"collection_name": "<collection_name>",
"end": "<end>",
"limit": 10,
"start": "<start>"
}

List Objects By Version

SDK: custom_storage.ListObjectsByVersion

Parameters:

NameTypeRequiredDescription
collection_namestringNoThe name of the collection
collection_versionstringNoThe version of the collection
endstringNoThe end key to end listing to
limitnumberNoThe limit of results to return
startstringNoThe start key to start listing from

Example:

{
"collection_name": "<collection_name>",
"collection_version": "<collection_version>",
"end": "<end>",
"limit": 10,
"start": "<start>"
}

List Schemas

SDK: custom_storage.ListSchemas

Parameters:

NameTypeRequiredDescription
collection_namestringNoThe name of the collection
endstringNoThe end key to end listing to
limitnumberNoThe limit of results to return
startstringNoThe start key to start listing from

Example:

{
"collection_name": "<collection_name>",
"end": "<end>",
"limit": 10,
"start": "<start>"
}

Put Object

SDK: custom_storage.PutObject

Parameters:

NameTypeRequiredDescription
collection_namestringNoThe name of the collection
dry_runbooleanNoIf false, run the operation as normal. If true, validate that the request would succeed, but do...
object_keystringNoThe object key
schema_versionstringNoThe version of the collection schema

Example:

{
"collection_name": "<collection_name>",
"dry_run": true,
"object_key": "<object_key>",
"schema_version": "<schema_version>"
}

Put Object By Version

SDK: custom_storage.PutObjectByVersion

Parameters:

NameTypeRequiredDescription
collection_namestringNoThe name of the collection
collection_versionstringNoThe version of the collection
dry_runbooleanNoIf false, run the operation as normal. If true, validate that the request would succeed, but do...
object_keystringNoThe object key

Example:

{
"collection_name": "<collection_name>",
"collection_version": "<collection_version>",
"dry_run": true,
"object_key": "<object_key>"
}

Search Objects

SDK: custom_storage.SearchObjects

Parameters:

NameTypeRequiredDescription
collection_namestringNoThe name of the collection
filterstringNoThe filter to limit the returned results.
limitnumberNoThe limit of results to return
offsetnumberNoThe offset of results to return
sortstringNoThe sort order for the returned results.

Example:

{
"collection_name": "<collection_name>",
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Search Objects By Version

SDK: custom_storage.SearchObjectsByVersion

Parameters:

NameTypeRequiredDescription
collection_namestringNoThe name of the collection
collection_versionstringNoThe version of the collection
filterstringNoThe filter to limit the returned results.
limitnumberNoThe limit of results to return
offsetnumberNoThe offset of results to return
sortstringNoThe sort order for the returned results.

Example:

{
"collection_name": "<collection_name>",
"collection_version": "<collection_version>",
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Data Protection Configuration

Operations for Data Protection Configuration

Operations

OperationNameDescription
entities_classification_delete_v2Entities Classification Delete V2SDK: data_protection_configuration.EntitiesClassificationDeleteV2
entities_classification_get_v2Entities Classification Get V2SDK: data_protection_configuration.EntitiesClassificationGetV2
entities_classification_patch_v2Entities Classification Patch V2SDK: data_protection_configuration.EntitiesClassificationPatchV2
entities_classification_post_v2Entities Classification Post V2SDK: data_protection_configuration.EntitiesClassificationPostV2
entities_cloud_application_createEntities Cloud Application CreateSDK: data_protection_configuration.EntitiesCloudApplicationCreate
entities_cloud_application_deleteEntities Cloud Application DeleteSDK: data_protection_configuration.EntitiesCloudApplicationDelete
entities_cloud_application_getEntities Cloud Application GetSDK: data_protection_configuration.EntitiesCloudApplicationGet
entities_cloud_application_patchEntities Cloud Application PatchSDK: data_protection_configuration.EntitiesCloudApplicationPatch
entities_content_pattern_createEntities Content Pattern CreateSDK: data_protection_configuration.EntitiesContentPatternCreate
entities_content_pattern_deleteEntities Content Pattern DeleteSDK: data_protection_configuration.EntitiesContentPatternDelete
entities_content_pattern_getEntities Content Pattern GetSDK: data_protection_configuration.EntitiesContentPatternGet
entities_content_pattern_patchEntities Content Pattern PatchSDK: data_protection_configuration.EntitiesContentPatternPatch
entities_enterprise_account_createEntities Enterprise Account CreateSDK: data_protection_configuration.EntitiesEnterpriseAccountCreate
entities_enterprise_account_deleteEntities Enterprise Account DeleteSDK: data_protection_configuration.EntitiesEnterpriseAccountDelete
entities_enterprise_account_getEntities Enterprise Account GetSDK: data_protection_configuration.EntitiesEnterpriseAccountGet
entities_enterprise_account_patchEntities Enterprise Account PatchSDK: data_protection_configuration.EntitiesEnterpriseAccountPatch
entities_file_type_getEntities File Type GetSDK: data_protection_configuration.EntitiesFileTypeGet
entities_policy_delete_v2Entities Policy Delete V2SDK: data_protection_configuration.EntitiesPolicyDeleteV2
entities_policy_get_v2Entities Policy Get V2SDK: data_protection_configuration.EntitiesPolicyGetV2
entities_policy_patch_v2Entities Policy Patch V2SDK: data_protection_configuration.EntitiesPolicyPatchV2
entities_policy_post_v2Entities Policy Post V2SDK: data_protection_configuration.EntitiesPolicyPostV2
entities_sensitivity_label_create_v2Entities Sensitivity Label Create V2SDK: data_protection_configuration.EntitiesSensitivityLabelCreateV2
entities_sensitivity_label_delete_v2Entities Sensitivity Label Delete V2SDK: data_protection_configuration.EntitiesSensitivityLabelDeleteV2
entities_sensitivity_label_get_v2Entities Sensitivity Label Get V2SDK: data_protection_configuration.EntitiesSensitivityLabelGetV2
entities_web_location_create_v2Entities Web Location Create V2SDK: data_protection_configuration.EntitiesWebLocationCreateV2
entities_web_location_delete_v2Entities Web Location Delete V2SDK: data_protection_configuration.EntitiesWebLocationDeleteV2
entities_web_location_get_v2Entities Web Location Get V2SDK: data_protection_configuration.EntitiesWebLocationGetV2
entities_web_location_patch_v2Entities Web Location Patch V2SDK: data_protection_configuration.EntitiesWebLocationPatchV2
queries_classification_get_v2Queries Classification Get V2SDK: data_protection_configuration.QueriesClassificationGetV2
queries_cloud_application_get_v2Queries Cloud Application Get V2SDK: data_protection_configuration.QueriesCloudApplicationGetV2
queries_content_pattern_get_v2Queries Content Pattern Get V2SDK: data_protection_configuration.QueriesContentPatternGetV2
queries_enterprise_account_get_v2Queries Enterprise Account Get V2SDK: data_protection_configuration.QueriesEnterpriseAccountGetV2
queries_file_type_get_v2Queries File Type Get V2SDK: data_protection_configuration.QueriesFileTypeGetV2
queries_policy_get_v2Queries Policy Get V2SDK: data_protection_configuration.QueriesPolicyGetV2
queries_sensitivity_label_get_v2Queries Sensitivity Label Get V2SDK: data_protection_configuration.QueriesSensitivityLabelGetV2
queries_web_location_get_v2Queries Web Location Get V2SDK: data_protection_configuration.QueriesWebLocationGetV2

Entities Classification Delete V2

SDK: data_protection_configuration.EntitiesClassificationDeleteV2

Parameters:

NameTypeRequiredDescription
idsarrayNoIDs of the classifications to delete

Example:

{
"ids": ["<ids>"]
}

Entities Classification Get V2

SDK: data_protection_configuration.EntitiesClassificationGetV2

Parameters:

NameTypeRequiredDescription
idsarrayNoIDs of the classifications to get

Example:

{
"ids": ["<ids>"]
}

Entities Classification Patch V2

SDK: data_protection_configuration.EntitiesClassificationPatchV2

Parameters:

NameTypeRequiredDescription
resourcesarrayYesBatch operation - array of JSON strings. Each item should be: {"field1":"value1","field2":"value...

Example:

{
"resources": ["<resources>"]
}

Entities Classification Post V2

SDK: data_protection_configuration.EntitiesClassificationPostV2

Parameters:

NameTypeRequiredDescription
resourcesarrayYesBatch operation - array of JSON strings. Each item should be: {"field1":"value1","field2":"value...

Example:

{
"resources": ["<resources>"]
}

Entities Cloud Application Create

SDK: data_protection_configuration.EntitiesCloudApplicationCreate

Parameters:

NameTypeRequiredDescription
descriptionstringNodescription. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
namestringNoname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
urlsobjectYesurls. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"description": "<description>",
"name": "<name>",
"urls": {}
}

Entities Cloud Application Delete

SDK: data_protection_configuration.EntitiesCloudApplicationDelete

Parameters:

NameTypeRequiredDescription
idsarrayNoThe id of the cloud application to delete.

Example:

{
"ids": ["<ids>"]
}

Entities Cloud Application Get

SDK: data_protection_configuration.EntitiesCloudApplicationGet

Parameters:

NameTypeRequiredDescription
idsarrayNoThe cloud application id(s) to get.

Example:

{
"ids": ["<ids>"]
}

Entities Cloud Application Patch

SDK: data_protection_configuration.EntitiesCloudApplicationPatch

Parameters:

NameTypeRequiredDescription
descriptionstringNodescription. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
namestringNoname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
urlsobjectYesurls. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"description": "<description>",
"name": "<name>",
"urls": {}
}

Entities Content Pattern Create

SDK: data_protection_configuration.EntitiesContentPatternCreate

Parameters:

NameTypeRequiredDescription
categorystringYescategory. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
descriptionstringYesdescription. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
examplestringYesexample. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
min_match_thresholdnumberYesmin match threshold. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/op...
namestringNoname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
regexesarrayYesregexes. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
regionstringYesregion. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"category": "<category>",
"description": "<description>",
"example": "<example>",
"min_match_threshold": 10,
"name": "<name>",
"regexes": ["<regexes>"],
"region": "<region>"
}

Entities Content Pattern Delete

SDK: data_protection_configuration.EntitiesContentPatternDelete

Parameters:

NameTypeRequiredDescription
idsarrayNoThe id(s) of the content pattern to delete.

Example:

{
"ids": ["<ids>"]
}

Entities Content Pattern Get

SDK: data_protection_configuration.EntitiesContentPatternGet

Parameters:

NameTypeRequiredDescription
idsarrayNoThe content-pattern id(s) to get.

Example:

{
"ids": ["<ids>"]
}

Entities Content Pattern Patch

SDK: data_protection_configuration.EntitiesContentPatternPatch

Parameters:

NameTypeRequiredDescription
categorystringYescategory. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
descriptionstringYesdescription. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
examplestringYesexample. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
idstringYes
min_match_thresholdnumberYesmin match threshold. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/op...
namestringNoname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
regexesarrayYesregexes. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
regionstringYesregion. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"category": "<category>",
"description": "<description>",
"example": "<example>",
"id": "<id>",
"min_match_threshold": 10,
"name": "<name>",
"regexes": ["<regexes>"],
"region": "<region>"
}

Entities Enterprise Account Create

SDK: data_protection_configuration.EntitiesEnterpriseAccountCreate

Parameters:

NameTypeRequiredDescription
application_group_idstringYesapplication group id
domainsarrayYesdomains. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
namestringYesname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
plugin_config_idstringYesplugin config id. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"application_group_id": "<application_group_id>",
"domains": ["<domains>"],
"name": "<name>",
"plugin_config_id": "<plugin_config_id>"
}

Entities Enterprise Account Delete

SDK: data_protection_configuration.EntitiesEnterpriseAccountDelete

Parameters:

NameTypeRequiredDescription
idsarrayNoThe id of the enterprise account to delete.

Example:

{
"ids": ["<ids>"]
}

Entities Enterprise Account Get

SDK: data_protection_configuration.EntitiesEnterpriseAccountGet

Parameters:

NameTypeRequiredDescription
idsarrayNoThe enterprise-account id(s) to get.

Example:

{
"ids": ["<ids>"]
}

Entities Enterprise Account Patch

SDK: data_protection_configuration.EntitiesEnterpriseAccountPatch

Parameters:

NameTypeRequiredDescription
application_group_idstringYesapplication group id
domainsarrayYesdomains. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
idstringYes
namestringYesname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
plugin_config_idstringYesplugin config id. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"application_group_id": "<application_group_id>",
"domains": ["<domains>"],
"id": "<id>",
"name": "<name>",
"plugin_config_id": "<plugin_config_id>"
}

Entities File Type Get

SDK: data_protection_configuration.EntitiesFileTypeGet

Parameters:

NameTypeRequiredDescription
idsarrayNoThe file-type id(s) to get.

Example:

{
"ids": ["<ids>"]
}

Entities Policy Delete V2

SDK: data_protection_configuration.EntitiesPolicyDeleteV2

Parameters:

NameTypeRequiredDescription
idsarrayNoIDs of the policies to delete
platform_namestringNoplatform name of the policies to update, either 'win' or 'mac'

Example:

{
"ids": ["<ids>"],
"platform_name": "<platform_name>"
}

Entities Policy Get V2

SDK: data_protection_configuration.EntitiesPolicyGetV2

Parameters:

NameTypeRequiredDescription
idsarrayNoIDs of the policies to get

Example:

{
"ids": ["<ids>"]
}

Entities Policy Patch V2

SDK: data_protection_configuration.EntitiesPolicyPatchV2

Parameters:

NameTypeRequiredDescription
resourcesarrayYesBatch operation - array of JSON strings. Each item should be: {"field1":"value1","field2":"value...

Example:

{
"resources": ["<resources>"]
}

Entities Policy Post V2

SDK: data_protection_configuration.EntitiesPolicyPostV2

Parameters:

NameTypeRequiredDescription
resourcesarrayYesBatch operation - array of JSON strings. Each item should be: {"field1":"value1","field2":"value...

Example:

{
"resources": ["<resources>"]
}

Entities Sensitivity Label Create V2

SDK: data_protection_configuration.EntitiesSensitivityLabelCreateV2

Parameters:

NameTypeRequiredDescription
co_authoringbooleanYesco authoring. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
display_namestringYesdisplay name. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
external_idstringYesexternal id. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
label_providerstringYeslabel provider. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
namestringYesname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
plugins_configuration_idstringYesplugins configuration id
syncedbooleanYessynced. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"co_authoring": true,
"display_name": "<display_name>",
"external_id": "<external_id>",
"label_provider": "<label_provider>",
"name": "<name>",
"plugins_configuration_id": "<plugins_configuration_id>",
"synced": true
}

Entities Sensitivity Label Delete V2

SDK: data_protection_configuration.EntitiesSensitivityLabelDeleteV2

Parameters:

NameTypeRequiredDescription
idsarrayNoThe sensitivity label entity id(s) to delete.

Example:

{
"ids": ["<ids>"]
}

Entities Sensitivity Label Get V2

SDK: data_protection_configuration.EntitiesSensitivityLabelGetV2

Parameters:

NameTypeRequiredDescription
idsarrayNoThe sensitivity label entity id(s) to get.

Example:

{
"ids": ["<ids>"]
}

Entities Web Location Create V2

SDK: data_protection_configuration.EntitiesWebLocationCreateV2

Parameters:

NameTypeRequiredDescription
web_locationsobjectYesweb locations. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"web_locations": {}
}

Entities Web Location Delete V2

SDK: data_protection_configuration.EntitiesWebLocationDeleteV2

Parameters:

NameTypeRequiredDescription
idsarrayNoThe ids of the web-location to delete.

Example:

{
"ids": ["<ids>"]
}

Entities Web Location Get V2

SDK: data_protection_configuration.EntitiesWebLocationGetV2

Parameters:

NameTypeRequiredDescription
idsarrayNoThe web-location entity id(s) to get.

Example:

{
"ids": ["<ids>"]
}

Entities Web Location Patch V2

SDK: data_protection_configuration.EntitiesWebLocationPatchV2

Parameters:

NameTypeRequiredDescription
application_idstringNoapplication id. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
cidstringNocid. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
deletedbooleanYesdeleted. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
enterprise_account_idstringNoenterprise account id
idstringYes
location_typestringYeslocation type. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
namestringNoname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
provider_location_idstringNoprovider location id
provider_location_namestringNoprovider location name
typestringYestype. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"application_id": "<application_id>",
"cid": "<cid>",
"deleted": true,
"enterprise_account_id": "<enterprise_account_id>",
"id": "<id>",
"location_type": "<location_type>",
"name": "<name>",
"provider_location_id": "<provider_location_id>",
"provider_location_name": "<provider_location_name>",
"type": "<type>"
}

Queries Classification Get V2

SDK: data_protection_configuration.QueriesClassificationGetV2

Parameters:

NameTypeRequiredDescription
filterstringNoFilter results by specific attributes , allowed attributes are [created_by modified_by modified_a...
limitnumberNoThe maximum records to return Default: 100
offsetnumberNoThe offset to start retrieving records from
sortstringNoThe property to sort by, allowed fields are :[name created_at modified_at]

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Queries Cloud Application Get V2

SDK: data_protection_configuration.QueriesCloudApplicationGetV2

Parameters:

NameTypeRequiredDescription
filterstringNoOptional filter for searching cloud applications. Allowed filters are 'name' (string), 'type' (ar...
limitnumberNoThe number of items to return in this response (default: 100, max: 500). Use with the offset para...
offsetnumberNoThe offset to start retrieving records from. Use with the limit parameter to manage pagination of...
sortstringNoThe sort instructions to order by on. Allowed values are 'name' (string), 'type' (array of string...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Queries Content Pattern Get V2

SDK: data_protection_configuration.QueriesContentPatternGetV2

Parameters:

NameTypeRequiredDescription
filterstringNoThe filter to use when finding content patterns. Allowed filters are 'name', 'type', 'category', ...
limitnumberNoThe number of items to return in this response (default: 100, max: 500). Use with the offset para...
offsetnumberNoThe offset to start retrieving records from. Use with the limit parameter to manage pagination of...
sortstringNoThe sort instructions to order by on. Allowed values are 'name', 'type', 'category', 'region', 'c...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Queries Enterprise Account Get V2

SDK: data_protection_configuration.QueriesEnterpriseAccountGetV2

Parameters:

NameTypeRequiredDescription
filterstringNoThe filter to use when finding enterprise accounts. Allowed filters are 'name', 'application_grou...
limitnumberNoThe number of items to return in this response (default: 100, max: 500). Use with the offset para...
offsetnumberNoThe offset to start retrieving records from. Use with the limit parameter to manage pagination of...
sortstringNoThe sort instructions to order by on. Allowed values are 'name', 'application_group_id', 'deleted...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Queries File Type Get V2

SDK: data_protection_configuration.QueriesFileTypeGetV2

Parameters:

NameTypeRequiredDescription
filterstringNoThe filter to use when finding file types. Allowed filter is 'name', 'created_at' and 'updated_at'
limitnumberNoThe number of items to return in this response (default: 100, max: 500). Use with the offset para...
offsetnumberNoThe offset to start retrieving records from. Use with the limit parameter to manage pagination of...
sortstringNoThe sort instructions to order by on. Allowed values are 'name', 'created_at' and 'updated_at'

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Queries Policy Get V2

SDK: data_protection_configuration.QueriesPolicyGetV2

Parameters:

NameTypeRequiredDescription
filterstringNoFilter results by specific attributes , allowed attributes are [properties.max_file_size_to_inspe...
limitnumberNoThe maximum records to return Default: 100
offsetnumberNoThe offset to start retrieving records from
platform_namestringNoplatform name of the policies to search, either 'win' or 'mac'
sortstringNoThe property to sort by, allowed fields are :[name precedence created_at modified_at]

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"platform_name": "<platform_name>",
"sort": "<sort>"
}

Queries Sensitivity Label Get V2

SDK: data_protection_configuration.QueriesSensitivityLabelGetV2

Parameters:

NameTypeRequiredDescription
filterstringNoThe filter to use when finding sensitivity labels. The only allowed filters are 'name', 'display_...
limitnumberNoThe number of items to return in this response (default: 100, max: 500). Use with the offset para...
offsetnumberNoThe offset to start retrieving records from. Use with the limit parameter to manage pagination of...
sortstringNoThe sort instructions to order by on. Allowed values are 'name', 'display_name', 'deleted', 'crea...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Queries Web Location Get V2

SDK: data_protection_configuration.QueriesWebLocationGetV2

Parameters:

NameTypeRequiredDescription
filterstringNoThe filter to use when finding web locations. Allowed filters are 'name', 'type', 'deleted', 'app...
limitnumberNoThe number of items to return in this response (default: 100, max: 500). Use with the offset para...
offsetnumberNoThe offset to start retrieving records from. Use with the limit parameter to manage pagination of...
typestringNoThe type of entity to query. Allowed values are 'predefined' and 'custom'

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"type": "<type>"
}

Delivery Settings

Operations for Delivery Settings

Operations

OperationNameDescription
get_delivery_settingsGet Delivery SettingsSDK: delivery_settings.GetDeliverySettings
post_delivery_settingsPost Delivery SettingsSDK: delivery_settings.PostDeliverySettings

Get Delivery Settings

SDK: delivery_settings.GetDeliverySettings

This operation has no parameters.

Example:

{
}

Post Delivery Settings

SDK: delivery_settings.PostDeliverySettings

Parameters:

NameTypeRequiredDescription
delivery_settingsobjectYesdelivery settings. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/open...

Example:

{
"delivery_settings": {}
}

Deployments

Operations for Deployments

Operations

OperationNameDescription
get_deployments_external_Get Deployments ExternalSDK: deployments.GetDeploymentsExternalV1

Get Deployments External

SDK: deployments.GetDeploymentsExternalV1

Parameters:

NameTypeRequiredDescription
authorizationstringNoauthorization header
xcsusernamestringNouser name
idsarrayNorelease version ids to retrieve deployment details

Example:

{
"authorization": "<authorization>",
"xcsusername": "<xcsusername>",
"ids": ["<ids>"]
}

Downloads Api

Operations for Downloads Api

Operations

OperationNameDescription
download_fileDownload FileSDK: downloads_api.DownloadFile
enumerate_fileEnumerate FileSDK: downloads_api.EnumerateFile
fetch_files_download_infoFetch Files Download InfoSDK: downloads_api.FetchFilesDownloadInfo

Download File

SDK: downloads_api.DownloadFile

Parameters:

NameTypeRequiredDescription
file_namestringNoName of the file to be downloaded
file_versionstringNoVersion of the file to be downloaded

Example:

{
"file_name": "<file_name>",
"file_version": "<file_version>"
}

Enumerate File

SDK: downloads_api.EnumerateFile

Parameters:

NameTypeRequiredDescription
archstringNoApply filtering on architecture
categorystringNoApply filtering on file category
file_namestringNoApply filtering on file name
file_versionstringNoApply filtering on file version
osstringNoApply filtering on operating system
platformstringNoApply filtering on file platform

Example:

{
"arch": "<arch>",
"category": "<category>",
"file_name": "<file_name>",
"file_version": "<file_version>",
"os": "<os>",
"platform": "<platform>"
}

Fetch Files Download Info

SDK: downloads_api.FetchFilesDownloadInfo

Parameters:

NameTypeRequiredDescription
filterstringNoSearch files using various filters using query in Falcon Query Language (FQL). Supported filters:...
sortstringNoThe fields to sort records on. Supported columns: - arch - category - file_name - `file_ver...

Example:

{
"filter": "<filter>",
"sort": "<sort>"
}

Event Streams

Operations for Event Streams

Operations

OperationNameDescription
list_available_streams_oauth2List Available Streams Oauth2SDK: event_streams.ListAvailableStreamsOAuth2
refresh_active_stream_sessionRefresh Active Stream SessionSDK: event_streams.RefreshActiveStreamSession

List Available Streams Oauth2

SDK: event_streams.ListAvailableStreamsOAuth2

Parameters:

NameTypeRequiredDescription
app_idstringNoLabel that identifies your connection. Max: 32 alphanumeric characters (a-z, A-Z, 0-9).
formatstringNoFormat for streaming events. Valid values: json, flatjson

Example:

{
"app_id": "<app_id>",
"format": "<format>"
}

Refresh Active Stream Session

SDK: event_streams.RefreshActiveStreamSession

Parameters:

NameTypeRequiredDescription
action_namestringNoAction name. Allowed value is refresh_active_stream_session.
app_idstringNoLabel that identifies your connection. Max: 32 alphanumeric characters (a-z, A-Z, 0-9).
partitionnumberNoPartition to request data for.

Example:

{
"action_name": "<action_name>",
"app_id": "<app_id>",
"partition": 10
}

Execution

Operations for Execution

Operations

OperationNameDescription
read_request_bodyRead Request BodySDK: execution.ReadRequestBody

Read Request Body

SDK: execution.ReadRequestBody

Parameters:

NameTypeRequiredDescription
filenamestringNofilename to be retrieved
fnstringNofunction ref; form of $fn_id:$fn_version
idstringNoExecution ID
sha256stringNosha256 checksum for file to be retrieved

Example:

{
"filename": "<filename>",
"fn": "<fn>",
"id": "<id>",
"sha256": "<sha256>"
}

Falcon Complete Dashboard

Operations for Falcon Complete Dashboard

Operations

OperationNameDescription
aggregate_alertsAggregate AlertsSDK: falcon_complete_dashboard.AggregateAlerts
aggregate_allow_listAggregate Allow ListSDK: falcon_complete_dashboard.AggregateAllowList
aggregate_block_listAggregate Block ListSDK: falcon_complete_dashboard.AggregateBlockList
aggregate_detectionsAggregate DetectionsSDK: falcon_complete_dashboard.AggregateDetections
aggregate_device_count_collectionAggregate Device Count CollectionSDK: falcon_complete_dashboard.AggregateDeviceCountCollection
aggregate_escalationsAggregate EscalationsSDK: falcon_complete_dashboard.AggregateEscalations
aggregate_fcincidentsAggregate FcincidentsSDK: falcon_complete_dashboard.AggregateFCIncidents
aggregate_prevention_policyAggregate Prevention PolicySDK: falcon_complete_dashboard.AggregatePreventionPolicy
aggregate_remediationsAggregate RemediationsSDK: falcon_complete_dashboard.AggregateRemediations
aggregate_sensor_update_policyAggregate Sensor Update PolicySDK: falcon_complete_dashboard.AggregateSensorUpdatePolicy
aggregate_support_issuesAggregate Support IssuesSDK: falcon_complete_dashboard.AggregateSupportIssues
aggregate_total_device_countsAggregate Total Device CountsSDK: falcon_complete_dashboard.AggregateTotalDeviceCounts
get_device_count_collection_queries_by_filterGet Device Count Collection Queries By FilterSDK: falcon_complete_dashboard.GetDeviceCountCollectionQueriesByFilter
list_alert_ids_by_filterList Alert Ids By FilterSDK: falcon_complete_dashboard.QueryAlertIdsByFilter
list_alert_ids_by_filter_v2List Alert Ids By Filter V2SDK: falcon_complete_dashboard.QueryAlertIdsByFilterV2
list_allow_list_filterList Allow List FilterSDK: falcon_complete_dashboard.QueryAllowListFilter
list_block_list_filterList Block List FilterSDK: falcon_complete_dashboard.QueryBlockListFilter
list_detection_ids_by_filterList Detection Ids By FilterSDK: falcon_complete_dashboard.QueryDetectionIdsByFilter
list_escalations_filterList Escalations FilterSDK: falcon_complete_dashboard.QueryEscalationsFilter
list_incident_ids_by_filterList Incident Ids By FilterSDK: falcon_complete_dashboard.QueryIncidentIdsByFilter
list_remediations_filterList Remediations FilterSDK: falcon_complete_dashboard.QueryRemediationsFilter

Aggregate Alerts

SDK: falcon_complete_dashboard.AggregateAlerts

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Aggregate Allow List

SDK: falcon_complete_dashboard.AggregateAllowList

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Aggregate Block List

SDK: falcon_complete_dashboard.AggregateBlockList

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Aggregate Detections

SDK: falcon_complete_dashboard.AggregateDetections

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Aggregate Device Count Collection

SDK: falcon_complete_dashboard.AggregateDeviceCountCollection

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Aggregate Escalations

SDK: falcon_complete_dashboard.AggregateEscalations

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Aggregate Fcincidents

SDK: falcon_complete_dashboard.AggregateFCIncidents

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Aggregate Prevention Policy

SDK: falcon_complete_dashboard.AggregatePreventionPolicy

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Aggregate Remediations

SDK: falcon_complete_dashboard.AggregateRemediations

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Aggregate Sensor Update Policy

SDK: falcon_complete_dashboard.AggregateSensorUpdatePolicy

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Aggregate Support Issues

SDK: falcon_complete_dashboard.AggregateSupportIssues

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Aggregate Total Device Counts

SDK: falcon_complete_dashboard.AggregateTotalDeviceCounts

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Get Device Count Collection Queries By Filter

SDK: falcon_complete_dashboard.GetDeviceCountCollectionQueriesByFilter

Parameters:

NameTypeRequiredDescription
filterstringNoOptional filter and sort criteria in the form of an FQL query. For more information about FQL que...
limitnumberNoThe maximum records to return. [1-500]
offsetstringNoStarting index of overall result set from which to return ids.
sortstringNoThe property to sort on, followed by a dot (.), followed by the sort direction, either "asc" or "...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

List Alert Ids By Filter

SDK: falcon_complete_dashboard.QueryAlertIdsByFilter

Parameters:

NameTypeRequiredDescription
filterstringNoOptional filter and sort criteria in the form of an FQL query. For more information about FQL que...
limitnumberNoThe maximum records to return. [1-500]
offsetstringNoStarting index of overall result set from which to return ids.
sortstringNoThe property to sort on, followed by a dot (.), followed by the sort direction, either "asc" or "...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

List Alert Ids By Filter V2

SDK: falcon_complete_dashboard.QueryAlertIdsByFilterV2

Parameters:

NameTypeRequiredDescription
filterstringNoOptional filter and sort criteria in the form of an FQL query. For more information about FQL que...
limitnumberNoThe maximum records to return. [1-500]
offsetstringNoStarting index of overall result set from which to return ids.
sortstringNoThe property to sort on, followed by a dot (.), followed by the sort direction, either "asc" or "...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

List Allow List Filter

SDK: falcon_complete_dashboard.QueryAllowListFilter

Parameters:

NameTypeRequiredDescription
filterstringNoOptional filter and sort criteria in the form of an FQL query. For more information about FQL que...
limitnumberNoThe maximum records to return. [1-500]
offsetstringNoStarting index of overall result set from which to return ids.
sortstringNoThe property to sort on, followed by a dot (.), followed by the sort direction, either "asc" or "...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

List Block List Filter

SDK: falcon_complete_dashboard.QueryBlockListFilter

Parameters:

NameTypeRequiredDescription
filterstringNoOptional filter and sort criteria in the form of an FQL query. For more information about FQL que...
limitnumberNoThe maximum records to return. [1-500]
offsetstringNoStarting index of overall result set from which to return ids.
sortstringNoThe property to sort on, followed by a dot (.), followed by the sort direction, either "asc" or "...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

List Detection Ids By Filter

SDK: falcon_complete_dashboard.QueryDetectionIdsByFilter

Parameters:

NameTypeRequiredDescription
filterstringNoOptional filter and sort criteria in the form of an FQL query. For more information about FQL que...
limitnumberNoThe maximum records to return. [1-500]
offsetstringNoStarting index of overall result set from which to return ids.
sortstringNoThe property to sort on, followed by a dot (.), followed by the sort direction, either "asc" or "...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

List Escalations Filter

SDK: falcon_complete_dashboard.QueryEscalationsFilter

Parameters:

NameTypeRequiredDescription
filterstringNoOptional filter and sort criteria in the form of an FQL query. For more information about FQL que...
limitnumberNoThe maximum records to return. [1-500]
offsetstringNoStarting index of overall result set from which to return ids.
sortstringNoThe property to sort on, followed by a dot (.), followed by the sort direction, either "asc" or "...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

List Incident Ids By Filter

SDK: falcon_complete_dashboard.QueryIncidentIdsByFilter

Parameters:

NameTypeRequiredDescription
filterstringNoOptional filter and sort criteria in the form of an FQL query. For more information about FQL que...
limitnumberNoThe maximum records to return. [1-500]
offsetstringNoStarting index of overall result set from which to return ids.
sortstringNoThe property to sort on, followed by a dot (.), followed by the sort direction, either "asc" or "...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

List Remediations Filter

SDK: falcon_complete_dashboard.QueryRemediationsFilter

Parameters:

NameTypeRequiredDescription
filterstringNoOptional filter and sort criteria in the form of an FQL query. For more information about FQL que...
limitnumberNoThe maximum records to return. [1-500]
offsetstringNoStarting index of overall result set from which to return ids.
sortstringNoThe property to sort on, followed by a dot (.), followed by the sort direction, either "asc" or "...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

Foundry Logscale

Operations for Foundry Logscale

Operations

OperationNameDescription
create_saved_searches_dynamic_execute_alt_Create Saved Searches Dynamic Execute AltSDK: foundry_logscale.CreateSavedSearchesDynamicExecuteAltV1
create_saved_searches_execute_alt_Create Saved Searches Execute AltSDK: foundry_logscale.CreateSavedSearchesExecuteAltV1
create_saved_searches_ingest_alt_Create Saved Searches Ingest AltSDK: foundry_logscale.CreateSavedSearchesIngestAltV1
download_resultsDownload ResultsSDK: foundry_logscale.DownloadResults
executeExecuteSDK: foundry_logscale.Execute
execute_dynamicExecute DynamicSDK: foundry_logscale.ExecuteDynamic
get_saved_searches_execute_alt_Get Saved Searches Execute AltSDK: foundry_logscale.GetSavedSearchesExecuteAltV1
get_saved_searches_job_results_download_alt_Get Saved Searches Job Results Download AltSDK: foundry_logscale.GetSavedSearchesJobResultsDownloadAltV1
get_search_resultsGet Search ResultsSDK: foundry_logscale.GetSearchResults
ingest_dataIngest DataSDK: foundry_logscale.IngestData
ingest_data_async_Ingest Data AsyncSDK: foundry_logscale.IngestDataAsyncV1
list_reposList ReposSDK: foundry_logscale.ListRepos
list_viewsList ViewsSDK: foundry_logscale.ListViews
populatePopulateSDK: foundry_logscale.Populate

Create Saved Searches Dynamic Execute Alt

SDK: foundry_logscale.CreateSavedSearchesDynamicExecuteAltV1

Parameters:

NameTypeRequiredDescription
endstringNoend. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
repo_or_viewstringYesrepo or view. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
search_querystringYessearch query. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
startstringNostart. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"end": "<end>",
"repo_or_view": "<repo_or_view>",
"search_query": "<search_query>",
"start": "<start>"
}

Create Saved Searches Execute Alt

SDK: foundry_logscale.CreateSavedSearchesExecuteAltV1

Parameters:

NameTypeRequiredDescription
endstringNoend. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
idstringNo
modestringNomode. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
namestringNoname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
startstringNostart. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
versionstringNoversion. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
with_inobjectNowith in. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
with_limitobjectNowith limit. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
with_renamesobjectYeswith renames. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
with_sortobjectNowith sort. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"end": "<end>",
"id": "<id>",
"mode": "<mode>",
"name": "<name>",
"start": "<start>",
"version": "<version>",
"with_in": {},
"with_limit": {},
"with_renames": {},
"with_sort": {}
}

Create Saved Searches Ingest Alt

SDK: foundry_logscale.CreateSavedSearchesIngestAltV1

Parameters:

NameTypeRequiredDescription
app_idstringNoApplication ID.

Example:

{
"app_id": "<app_id>"
}

Download Results

SDK: foundry_logscale.DownloadResults

Parameters:

NameTypeRequiredDescription
infer_json_typesbooleanNoWhether to try to infer data types in json event response instead of returning map[string]string
job_idstringNoJob ID for a previously executed async query
result_formatstringNoResult Format. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"infer_json_types": true,
"job_id": "<job_id>",
"result_format": "<result_format>"
}

Execute

SDK: foundry_logscale.Execute

Parameters:

NameTypeRequiredDescription
endstringNoend. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
idstringNo
modestringNomode. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
namestringNoname. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
startstringNostart. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
versionstringNoversion. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
with_inobjectNowith in. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
with_limitobjectNowith limit. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
with_renamesobjectYeswith renames. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
with_sortobjectNowith sort. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"end": "<end>",
"id": "<id>",
"mode": "<mode>",
"name": "<name>",
"start": "<start>",
"version": "<version>",
"with_in": {},
"with_limit": {},
"with_renames": {},
"with_sort": {}
}

Execute Dynamic

SDK: foundry_logscale.ExecuteDynamic

Parameters:

NameTypeRequiredDescription
endstringNoend. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
repo_or_viewstringYesrepo or view. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
search_querystringYessearch query. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
startstringNostart. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"end": "<end>",
"repo_or_view": "<repo_or_view>",
"search_query": "<search_query>",
"start": "<start>"
}

Get Saved Searches Execute Alt

SDK: foundry_logscale.GetSavedSearchesExecuteAltV1

Parameters:

NameTypeRequiredDescription
xcsuseruuidstringNoRequester UUID.
app_idstringNoApplication ID.
infer_json_typesbooleanNoWhether to try to infer data types in json event response instead of returning map[string]string
job_idstringNoJob ID for a previously executed async query
job_status_onlybooleanNoIf set to true, result rows are dropped from the response and only the job status is returned
limitstringNoMaximum number of records to return.
match_response_schemabooleanNoWhether to validate search results against their schema
metadatabooleanNoWhether to include metadata in the response
offsetstringNoStarting pagination offset of records to return.

Example:

{
"xcsuseruuid": "<xcsuseruuid>",
"app_id": "<app_id>",
"infer_json_types": true,
"job_id": "<job_id>",
"job_status_only": true,
"limit": "<limit>",
"match_response_schema": true,
"metadata": true,
"offset": "<offset>"
}

Get Saved Searches Job Results Download Alt

SDK: foundry_logscale.GetSavedSearchesJobResultsDownloadAltV1

Parameters:

NameTypeRequiredDescription
infer_json_typesbooleanNoWhether to try to infer data types in json event response instead of returning map[string]string
job_idstringNoJob ID for a previously executed async query
result_formatstringNoResult Format. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"infer_json_types": true,
"job_id": "<job_id>",
"result_format": "<result_format>"
}

Get Search Results

SDK: foundry_logscale.GetSearchResults

Parameters:

NameTypeRequiredDescription
xcsuseruuidstringNoRequester UUID.
app_idstringNoApplication ID.
infer_json_typesbooleanNoWhether to try to infer data types in json event response instead of returning map[string]string
job_idstringNoJob ID for a previously executed async query
job_status_onlybooleanNoIf set to true, result rows are dropped from the response and only the job status is returned
limitstringNoMaximum number of records to return.
match_response_schemabooleanNoWhether to validate search results against their schema
metadatabooleanNoWhether to include metadata in the response
offsetstringNoStarting pagination offset of records to return.

Example:

{
"xcsuseruuid": "<xcsuseruuid>",
"app_id": "<app_id>",
"infer_json_types": true,
"job_id": "<job_id>",
"job_status_only": true,
"limit": "<limit>",
"match_response_schema": true,
"metadata": true,
"offset": "<offset>"
}

Ingest Data

SDK: foundry_logscale.IngestData

Parameters:

NameTypeRequiredDescription
data_contentstringNoJSON data to ingest
tagarrayNoCustom tag for ingested data in the form tag:value
tag_sourcestringNoTag the data with the specified source
test_databooleanNoTag the data with test-ingest

Example:

{
"data_content": "<data_content>",
"tag": ["<tag>"],
"tag_source": "<tag_source>",
"test_data": true
}

Ingest Data Async

SDK: foundry_logscale.IngestDataAsyncV1

Parameters:

NameTypeRequiredDescription
data_contentstringNoJSON data to ingest
repostringNoRepository name if not part of a foundry app
tagarrayNoCustom tag for ingested data in the form tag:value
tag_sourcestringNoTag the data with the specified source
test_databooleanNoTag the data with test-ingest

Example:

{
"data_content": "<data_content>",
"repo": "<repo>",
"tag": ["<tag>"],
"tag_source": "<tag_source>",
"test_data": true
}

List Repos

SDK: foundry_logscale.ListRepos

Parameters:

NameTypeRequiredDescription
check_test_databooleanNoInclude whether test data is present in the application repository

Example:

{
"check_test_data": true
}

List Views

SDK: foundry_logscale.ListViews

Parameters:

NameTypeRequiredDescription
check_test_databooleanNoInclude whether test data is present in the application repository

Example:

{
"check_test_data": true
}

Populate

SDK: foundry_logscale.Populate

Parameters:

NameTypeRequiredDescription
app_idstringNoApplication ID.

Example:

{
"app_id": "<app_id>"
}

It Automation

Operations for It Automation

Operations

OperationNameDescription
itautomation_cancel_task_executionItautomation Cancel Task ExecutionSDK: it_automation.ITAutomationCancelTaskExecution
itautomation_combined_scheduled_tasksItautomation Combined Scheduled TasksSDK: it_automation.ITAutomationCombinedScheduledTasks
itautomation_create_policyItautomation Create PolicySDK: it_automation.ITAutomationCreatePolicy
itautomation_create_scheduled_taskItautomation Create Scheduled TaskSDK: it_automation.ITAutomationCreateScheduledTask
itautomation_create_taskItautomation Create TaskSDK: it_automation.ITAutomationCreateTask
itautomation_create_task_groupItautomation Create Task GroupSDK: it_automation.ITAutomationCreateTaskGroup
itautomation_create_user_groupItautomation Create User GroupSDK: it_automation.ITAutomationCreateUserGroup
itautomation_delete_policyItautomation Delete PolicySDK: it_automation.ITAutomationDeletePolicy
itautomation_delete_scheduled_tasksItautomation Delete Scheduled TasksSDK: it_automation.ITAutomationDeleteScheduledTasks
itautomation_delete_taskItautomation Delete TaskSDK: it_automation.ITAutomationDeleteTask
itautomation_delete_task_groupsItautomation Delete Task GroupsSDK: it_automation.ITAutomationDeleteTaskGroups
itautomation_delete_user_groupItautomation Delete User GroupSDK: it_automation.ITAutomationDeleteUserGroup
itautomation_get_associated_tasksItautomation Get Associated TasksSDK: it_automation.ITAutomationGetAssociatedTasks
itautomation_get_execution_resultsItautomation Get Execution ResultsSDK: it_automation.ITAutomationGetExecutionResults
itautomation_get_execution_results_search_statusItautomation Get Execution Results Search StatusSDK: it_automation.ITAutomationGetExecutionResultsSearchStatus
itautomation_get_policiesItautomation Get PoliciesSDK: it_automation.ITAutomationGetPolicies
itautomation_get_scheduled_tasksItautomation Get Scheduled TasksSDK: it_automation.ITAutomationGetScheduledTasks
itautomation_get_task_executionItautomation Get Task ExecutionSDK: it_automation.ITAutomationGetTaskExecution
itautomation_get_task_execution_host_statusItautomation Get Task Execution Host StatusSDK: it_automation.ITAutomationGetTaskExecutionHostStatus
itautomation_get_task_groupsItautomation Get Task GroupsSDK: it_automation.ITAutomationGetTaskGroups
itautomation_get_tasksItautomation Get TasksSDK: it_automation.ITAutomationGetTasks
itautomation_get_user_groupItautomation Get User GroupSDK: it_automation.ITAutomationGetUserGroup
itautomation_rerun_task_executionItautomation Rerun Task ExecutionSDK: it_automation.ITAutomationRerunTaskExecution
itautomation_search_scheduled_tasksItautomation Search Scheduled TasksSDK: it_automation.ITAutomationSearchScheduledTasks
itautomation_search_task_executionsItautomation Search Task ExecutionsSDK: it_automation.ITAutomationSearchTaskExecutions
itautomation_search_task_groupsItautomation Search Task GroupsSDK: it_automation.ITAutomationSearchTaskGroups
itautomation_search_tasksItautomation Search TasksSDK: it_automation.ITAutomationSearchTasks
itautomation_search_user_groupItautomation Search User GroupSDK: it_automation.ITAutomationSearchUserGroup
itautomation_start_execution_results_searchItautomation Start Execution Results SearchSDK: it_automation.ITAutomationStartExecutionResultsSearch
itautomation_start_task_executionItautomation Start Task ExecutionSDK: it_automation.ITAutomationStartTaskExecution
itautomation_update_policiesItautomation Update PoliciesSDK: it_automation.ITAutomationUpdatePolicies
itautomation_update_policies_precedenceItautomation Update Policies PrecedenceSDK: it_automation.ITAutomationUpdatePoliciesPrecedence
itautomation_update_policy_host_groupsItautomation Update Policy Host GroupsSDK: it_automation.ITAutomationUpdatePolicyHostGroups
itautomation_update_scheduled_taskItautomation Update Scheduled TaskSDK: it_automation.ITAutomationUpdateScheduledTask
itautomation_update_taskItautomation Update TaskSDK: it_automation.ITAutomationUpdateTask
itautomation_update_task_groupItautomation Update Task GroupSDK: it_automation.ITAutomationUpdateTaskGroup
itautomation_update_user_groupItautomation Update User GroupSDK: it_automation.ITAutomationUpdateUserGroup
list_itautomation_policiesList Itautomation PoliciesSDK: it_automation.ITAutomationQueryPolicies
list_itautomation_run_liveList Itautomation Run LiveSDK: it_automation.ITAutomationRunLiveQuery
list_itautomation_task_executions_byList Itautomation Task Executions BySDK: it_automation.ITAutomationGetTaskExecutionsByQuery
list_itautomation_task_groups_byList Itautomation Task Groups BySDK: it_automation.ITAutomationGetTaskGroupsByQuery
list_itautomation_tasks_byList Itautomation Tasks BySDK: it_automation.ITAutomationGetTasksByQuery

Itautomation Cancel Task Execution

SDK: it_automation.ITAutomationCancelTaskExecution

Parameters:

NameTypeRequiredDescription
task_execution_idstringYesID of the task execution to cancel. Example: f64b95555ef54ea682619ce880d267cc

Example:

{
"task_execution_id": "<task_execution_id>"
}

Itautomation Combined Scheduled Tasks

SDK: it_automation.ITAutomationCombinedScheduledTasks

Parameters:

NameTypeRequiredDescription
filterstringNoThe filter expression that should be used to limit the results. Allowed filter fields: [created_b...
limitnumberNoThe maximum records to return. Example: 50 Default: 100
offsetnumberNoStarting index for record retrieval. Example: 100
sortstringNoThe sort expression that should be used to sort the results. Allowed sort fields: [created_by, cr...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Itautomation Create Policy

SDK: it_automation.ITAutomationCreatePolicy

Parameters:

NameTypeRequiredDescription
configobjectNoConfiguration settings for the policy
descriptionstringYesDescription of the policy
namestringNoThe name of the policy
platformstringYesThe platform for the policy

Example:

{
"config": {},
"description": "<description>",
"name": "<name>",
"platform": "<platform>"
}

Itautomation Create Scheduled Task

SDK: it_automation.ITAutomationCreateScheduledTask

Parameters:

NameTypeRequiredDescription
discover_new_hostsbooleanNoWhether to discover new hosts for the scheduled task. Example: true
discover_offline_hostsbooleanNoWhether to discover offline hosts for the scheduled task. Example: true
distributebooleanNoWhether to distribute the scheduled task. Example: true
expiration_intervalstringNoDuration for which the task stays active. Once expired, new and offline hosts won't be targeted. ...
guardrailsobjectNoSafety limits for task execution
is_activebooleanYesWhether the scheduled task is active. Example: true
scheduleobjectYesSchedule details for the task execution
scheduled_namestringNoCustom name for the scheduled task. Example: Weekly Security Scan
targetstringYesFilter expression to select target hosts. Example: platform_name:'Windows'
task_idstringYesUnique identifier of the task to be scheduled. Example: f64b95555ef54ea682619ce880d267cc
trigger_conditionobjectYesConditions that trigger remediation actions

Example:

{
"discover_new_hosts": true,
"discover_offline_hosts": true,
"distribute": true,
"expiration_interval": "<expiration_interval>",
"guardrails": {},
"is_active": true,
"schedule": {},
"scheduled_name": "<scheduled_name>",
"target": "<target>",
"task_id": "<task_id>",
"trigger_condition": {}
}

Itautomation Create Task

SDK: it_automation.ITAutomationCreateTask

Parameters:

NameTypeRequiredDescription
access_typestringYesAccess type of the task
assigned_user_group_idsarrayYesAssigned user group IDs of the task, when access_type is Shared. Use GET /it-automation/queries/i...
assigned_user_idsarrayYesAssigned user IDs of the task, when access_type is Shared. Use GET /user-management/queries/users...
composite_queryobjectNoComposite query configuration containing task IDs and host attributes for multi-task execution
descriptionstringNoDetailed description of what the task does. Example: User Table Validation Check
namestringYesName of the task. Example: OSQuery Check
os_querystringNoOSQuery to execute. Example: select * from users
output_parser_configobjectNoSpecifies the columns and delimiter used to parse script execution results
queriesobjectNoScript queries to run per platform
remediationsobjectNoRemediation scripts to run per platform
rows_parser_configobjectNoConfiguration for parsing script output into multiple rows
targetstringYesTarget filter in FQL format. Example: platform_name: 'Windows'
task_group_idstringNoID of the task group to associate this task with
task_parametersobjectYesParameters for the task
task_typestringYesType of task
trigger_conditionobjectYesConditions that trigger remediation scripts execution
verification_conditionobjectYesConditions that verify the outcome of the remediation scripts execution

Example:

{
"access_type": "<access_type>",
"assigned_user_group_ids": ["<assigned_user_group_ids>"],
"assigned_user_ids": ["<assigned_user_ids>"],
"composite_query": {},
"description": "<description>",
"name": "<name>",
"os_query": "<os_query>",
"output_parser_config": {},
"queries": {},
"remediations": {},
"rows_parser_config": {},
"target": "<target>",
"task_group_id": "<task_group_id>",
"task_parameters": {},
"task_type": "<task_type>",
"trigger_condition": {},
"verification_condition": {}
}

Itautomation Create Task Group

SDK: it_automation.ITAutomationCreateTaskGroup

Parameters:

NameTypeRequiredDescription
access_typestringYesAccess type of the group
assigned_user_group_idsarrayYesAssigned user group IDs of the group, when access_type is Shared. Use GET /it-automation/queries/...
assigned_user_idsarrayYesAssigned user IDs of the group, when access_type is Shared. Use GET /user-management/queries/user...
descriptionstringNoDescription of the task group
namestringYesName of the task group
task_idsarrayYesIDs of existing tasks to add to task group upon creation. Use PATCH /it-automation/entities/task-...

Example:

{
"access_type": "<access_type>",
"assigned_user_group_ids": ["<assigned_user_group_ids>"],
"assigned_user_ids": ["<assigned_user_ids>"],
"description": "<description>",
"name": "<name>",
"task_ids": ["<task_ids>"]
}

Itautomation Create User Group

SDK: it_automation.ITAutomationCreateUserGroup

Parameters:

NameTypeRequiredDescription
descriptionstringNoDescription of the user group
namestringYesName of the user group

Example:

{
"description": "<description>",
"name": "<name>"
}

Itautomation Delete Policy

SDK: it_automation.ITAutomationDeletePolicy

Parameters:

NameTypeRequiredDescription
idsarrayNolist of task ids to delete

Example:

{
"ids": ["<ids>"]
}

Itautomation Delete Scheduled Tasks

SDK: it_automation.ITAutomationDeleteScheduledTasks

Parameters:

NameTypeRequiredDescription
idsarrayNoComma separated values of scheduled task IDs to delete

Example:

{
"ids": ["<ids>"]
}

Itautomation Delete Task

SDK: it_automation.ITAutomationDeleteTask

Parameters:

NameTypeRequiredDescription
idsarrayNoIDs of tasks to delete. Use ITAutomationSearchTasks to fetch IDs

Example:

{
"ids": ["<ids>"]
}

Itautomation Delete Task Groups

SDK: it_automation.ITAutomationDeleteTaskGroups

Parameters:

NameTypeRequiredDescription
idsarrayNoComma separated values of task group IDs to delete

Example:

{
"ids": ["<ids>"]
}

Itautomation Delete User Group

SDK: it_automation.ITAutomationDeleteUserGroup

Parameters:

NameTypeRequiredDescription
idsarrayNoComma separated values of user group ids to delete

Example:

{
"ids": ["<ids>"]
}

Itautomation Get Associated Tasks

SDK: it_automation.ITAutomationGetAssociatedTasks

Parameters:

NameTypeRequiredDescription
filterstringNoThe filter expression that should be used to limit the results. Allowed filter fields: [access_ty...
idstringNoThe ID of the file to fetch associated tasks for
limitnumberNoThe maximum records to return. Example: 50 Default: 100
offsetnumberNoStarting index for record retrieval. Example: 100
sortstringNoThe sort expression that should be used to sort the results. Allowed sort fields: [name]. Sort ei...

Example:

{
"filter": "<filter>",
"id": "<id>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Itautomation Get Execution Results

SDK: it_automation.ITAutomationGetExecutionResults

Parameters:

NameTypeRequiredDescription
idstringNoThe Job ID to fetch. Use the value returned from ITAutomationStartExecutionResultsSearch
limitnumberNoThe maximum number of event results to return Default: 500
offsetnumberNoThe offset to start retrieving records from
sortstringNoSort results by one of the fields in the event results, either asc (ascending) or desc (descendin...

Example:

{
"id": "<id>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Itautomation Get Execution Results Search Status

SDK: it_automation.ITAutomationGetExecutionResultsSearchStatus

Parameters:

NameTypeRequiredDescription
idstringNoSearch Job ID to fetch. UseITAutomationStartExecutionResultsSearch to get the job id

Example:

{
"id": "<id>"
}

Itautomation Get Policies

SDK: it_automation.ITAutomationGetPolicies

Parameters:

NameTypeRequiredDescription
idsarrayNoOne or more (up to 500) policy ids in the form of ids=ID1&ids=ID2

Example:

{
"ids": ["<ids>"]
}

Itautomation Get Scheduled Tasks

SDK: it_automation.ITAutomationGetScheduledTasks

Parameters:

NameTypeRequiredDescription
idsarrayNoScheduled task IDs to fetch. Use ITAutomationSearchScheduledTasks to fetch scheduled task IDs

Example:

{
"ids": ["<ids>"]
}

Itautomation Get Task Execution

SDK: it_automation.ITAutomationGetTaskExecution

Parameters:

NameTypeRequiredDescription
idsarrayNoTask execution IDs to fetch. Use ITAutomationSearchTaskExecutions to get the execution id

Example:

{
"ids": ["<ids>"]
}

Itautomation Get Task Execution Host Status

SDK: it_automation.ITAutomationGetTaskExecutionHostStatus

Parameters:

NameTypeRequiredDescription
filterstringNoThe filter expression that should be used to limit the results. Allowed filter fields: [end_time,...
idsarrayNoTask execution IDs to get statuses for. Use ITAutomationSearchTaskExecutions to fetch execution IDs
limitnumberNoThe maximum records to return. Example: 50 Default: 100
offsetnumberNoStarting index for record retrieval. Example: 100
sortstringNoThe sort expression that should be used to sort the results. Allowed sort fields: [end_time, star...

Example:

{
"filter": "<filter>",
"ids": ["<ids>"],
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Itautomation Get Task Groups

SDK: it_automation.ITAutomationGetTaskGroups

Parameters:

NameTypeRequiredDescription
idsarrayNoComma separated values of task group ids to fetch

Example:

{
"ids": ["<ids>"]
}

Itautomation Get Tasks

SDK: it_automation.ITAutomationGetTasks

Parameters:

NameTypeRequiredDescription
idsarrayNoIDs of tasks to fetch. Use ITAutomationSearchTasks to fetch IDs

Example:

{
"ids": ["<ids>"]
}

Itautomation Get User Group

SDK: it_automation.ITAutomationGetUserGroup

Parameters:

NameTypeRequiredDescription
idsarrayNoComma separated values of user group ids to fetch

Example:

{
"ids": ["<ids>"]
}

Itautomation Rerun Task Execution

SDK: it_automation.ITAutomationRerunTaskExecution

Parameters:

NameTypeRequiredDescription
run_typestringYesType of rerun. When set to hosts, re-run on same hosts again. When set to failed, re-run only on ...
task_execution_idstringYesID of the task execution to rerun. Example: f64b95555ef54ea682619ce880d267cc

Example:

{
"run_type": "<run_type>",
"task_execution_id": "<task_execution_id>"
}

Itautomation Search Scheduled Tasks

SDK: it_automation.ITAutomationSearchScheduledTasks

Parameters:

NameTypeRequiredDescription
filterstringNoThe filter expression that should be used to limit the results. Allowed filter fields: [created_b...
limitnumberNoThe maximum records to return. Example: 50 Default: 100
offsetnumberNoStarting index for record retrieval. Example: 100
sortstringNoThe sort expression that should be used to sort the results. Allowed sort fields: [created_by, cr...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Itautomation Search Task Executions

SDK: it_automation.ITAutomationSearchTaskExecutions

Parameters:

NameTypeRequiredDescription
filterstringNoThe filter expression that should be used to limit the results. Allowed filter fields: [end_time,...
limitnumberNoThe maximum records to return. Example: 50 Default: 100
offsetnumberNoStarting index for record retrieval. Example: 100
sortstringNoThe sort expression that should be used to sort the results. Allowed sort fields: [end_time, run_...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Itautomation Search Task Groups

SDK: it_automation.ITAutomationSearchTaskGroups

Parameters:

NameTypeRequiredDescription
filterstringNoThe filter expression that should be used to limit the results. Allowed filter fields: [access_ty...
limitnumberNoThe maximum records to return. Example: 50 Default: 100
offsetnumberNoStarting index for record retrieval. Example: 100
sortstringNoThe sort expression that should be used to sort the results. Allowed sort fields: [access_type, c...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Itautomation Search Tasks

SDK: it_automation.ITAutomationSearchTasks

Parameters:

NameTypeRequiredDescription
filterstringNoThe filter expression that should be used to limit the results. Allowed filter fields: [access_ty...
limitnumberNoThe maximum records to return. Example: 50 Default: 100
offsetnumberNoStarting index for record retrieval. Example: 100
sortstringNoThe sort expression that should be used to sort the results. Allowed sort fields: [access_type, c...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Itautomation Search User Group

SDK: it_automation.ITAutomationSearchUserGroup

Parameters:

NameTypeRequiredDescription
filterstringNoThe filter expression that should be used to limit the results. Allowed filter fields: [created_b...
limitnumberNoThe maximum records to return. Example: 50 Default: 100
offsetnumberNoStarting index for record retrieval. Example: 100
sortstringNoThe sort expression that should be used to sort the results. Allowed sort fields: [created_by, cr...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

SDK: it_automation.ITAutomationStartExecutionResultsSearch

Parameters:

NameTypeRequiredDescription
filter_expressionsarrayYesFilter expressions to limit results. Example: ["hostname:prod"]
group_by_fieldsarrayYesFields to group results by. Example: ["hostname", "status"]
search_endstringYesEnd time for the search period. Example: now
search_startstringYesStart time for the search period. Example: -1d
task_execution_idstringYesUnique identifier of the task execution to search. Example: f64b95555ef54ea682619ce880d267cc

Example:

{
"filter_expressions": ["<filter_expressions>"],
"group_by_fields": ["<group_by_fields>"],
"search_end": "<search_end>",
"search_start": "<search_start>",
"task_execution_id": "<task_execution_id>"
}

Itautomation Start Task Execution

SDK: it_automation.ITAutomationStartTaskExecution

Parameters:

NameTypeRequiredDescription
discover_new_hostsbooleanNoWhether to discover new hosts for the scheduled task. Example: true
discover_offline_hostsbooleanNoWhether to discover offline hosts for the scheduled task. Example: true
distributebooleanNoWhether to distribute the scheduled task. Example: true
expiration_intervalstringNoDuration for which the task stays active. Once expired, new and offline hosts won't be targeted. ...
guardrailsobjectNoExecution guardrails and limits
scheduled_task_idstringNoUnique identifier of existing scheduled task. Scheduled task fields override all other request fi...
targetstringNoTarget filter in FQL format. Example: platform_name: 'Windows'
task_idstringNoUnique identifier of existing saved task. Example: f64b95555ef54ea682619ce880d267cc
trigger_conditionobjectYesConditions that trigger remediation scripts execution

Example:

{
"discover_new_hosts": true,
"discover_offline_hosts": true,
"distribute": true,
"expiration_interval": "<expiration_interval>",
"guardrails": {},
"scheduled_task_id": "<scheduled_task_id>",
"target": "<target>",
"task_id": "<task_id>",
"trigger_condition": {}
}

Itautomation Update Policies

SDK: it_automation.ITAutomationUpdatePolicies

Parameters:

NameTypeRequiredDescription
configobjectNoConfiguration settings for the policy
descriptionstringNoDescription of the policy.Example: windows policy check
idstringNoID of the policy. Example: f64b95555ef54ea682619ce880d267cc
is_enabledbooleanNoWhether the policy is enabled or disabled
namestringNoName of the policy. Example: platform_policy

Example:

{
"config": {},
"description": "<description>",
"id": "<id>",
"is_enabled": true,
"name": "<name>"
}

Itautomation Update Policies Precedence

SDK: it_automation.ITAutomationUpdatePoliciesPrecedence

Parameters:

NameTypeRequiredDescription
idsarrayYesIDs of all the policy in precedence order for a give platform.

Example:

{
"ids": ["<ids>"]
}

Itautomation Update Policy Host Groups

SDK: it_automation.ITAutomationUpdatePolicyHostGroups

Parameters:

NameTypeRequiredDescription
actionstringYesThe action to perform with the provided ids, must be one of: assign, unassign.
host_group_idsarrayYesThe ids of the host groups on which to perform the action.
policy_idstringYesThe id of the policy on which to perform the action.

Example:

{
"action": "<action>",
"host_group_ids": ["<host_group_ids>"],
"policy_id": "<policy_id>"
}

Itautomation Update Scheduled Task

SDK: it_automation.ITAutomationUpdateScheduledTask

Parameters:

NameTypeRequiredDescription
discover_new_hostsbooleanNoWhether to discover new hosts for the scheduled task. Example: true
discover_offline_hostsbooleanNoWhether to discover offline hosts for the scheduled task. Example: true
distributebooleanNoWhether to distribute the scheduled task. Example: true
expiration_intervalstringNoDuration for which the task stays active. Once expired, new and offline hosts won't be targeted. ...
guardrailsobjectNoSafety limits for task execution
is_activebooleanNoWhether the scheduled task is active. Example: true
scheduleobjectNoSchedule details for the task execution
scheduled_namestringNoCustom name for the scheduled task. Example: Weekly Security Scan
targetstringNoFilter expression to select target hosts. Example: hostname:prod
task_idstringNoUnique identifier of the task to be scheduled. Example: f64b95555ef54ea682619ce880d267cc
trigger_conditionobjectYesConditions that trigger remediation actions

Example:

{
"discover_new_hosts": true,
"discover_offline_hosts": true,
"distribute": true,
"expiration_interval": "<expiration_interval>",
"guardrails": {},
"is_active": true,
"schedule": {},
"scheduled_name": "<scheduled_name>",
"target": "<target>",
"task_id": "<task_id>",
"trigger_condition": {}
}

Itautomation Update Task

SDK: it_automation.ITAutomationUpdateTask

Parameters:

NameTypeRequiredDescription
access_typestringNoAccess type of the task
add_assigned_user_group_idsarrayYesUser group IDs to add to the assigned user group IDs of the task, when access_type is Shared. Use...
add_assigned_user_idsarrayYesUser IDs to add to the assigned user IDs of the task, when access_type is Shared. Use GET /user-m...
composite_queryobjectNoComposite query configuration containing task IDs and host attributes for multi-task execution
descriptionstringNoDetailed description of what the task does. Example: User Table Validation Check
namestringNoName of the task. Example: OSQuery Check
os_querystringNoOSQuery to execute. Example: select * from users
output_parser_configobjectNoSpecifies the columns and delimiter used to parse script execution results
queriesobjectNoScript queries to run per platform
remediationsobjectNoRemediation scripts to run per platform
remove_assigned_user_group_idsarrayYesUser group IDs to remove from the assigned user group IDs of the task, when access_type is Shared...
remove_assigned_user_idsarrayYesUser IDs to remove from the assigned user IDs of the task, when access_type is Shared. Use GET /u...
rows_parser_configobjectNoConfiguration for parsing script output into multiple rows
targetstringNoTarget filter in FQL format. Example: platform_name: 'Windows'
task_group_idstringNoID of the task group to associate this task with
task_parametersobjectYesParameters for the task
task_typestringNoType of task
trigger_conditionobjectYesConditions that trigger remediation scripts execution
verification_conditionobjectYesConditions that verify the outcome of the remediation scripts execution

Example:

{
"access_type": "<access_type>",
"add_assigned_user_group_ids": ["<add_assigned_user_group_ids>"],
"add_assigned_user_ids": ["<add_assigned_user_ids>"],
"composite_query": {},
"description": "<description>",
"name": "<name>",
"os_query": "<os_query>",
"output_parser_config": {},
"queries": {},
"remediations": {},
"remove_assigned_user_group_ids": ["<remove_assigned_user_group_ids>"],
"remove_assigned_user_ids": ["<remove_assigned_user_ids>"],
"rows_parser_config": {},
"target": "<target>",
"task_group_id": "<task_group_id>",
"task_parameters": {},
"task_type": "<task_type>",
"trigger_condition": {},
"verification_condition": {}
}

Itautomation Update Task Group

SDK: it_automation.ITAutomationUpdateTaskGroup

Parameters:

NameTypeRequiredDescription
access_typestringNoAccess type of the group
add_assigned_user_group_idsarrayYesUser group IDs to add to the group, when access_type is Shared. Use GET /it-automation/queries/it...
add_assigned_user_idsarrayYesUser IDs to add to the group, when access_type is Shared. Use GET /user-management/queries/users/...
add_task_idsarrayYesIDs of existing tasks to add to task group. Get task ids via GET /it-automation/queries/task-grou...
descriptionstringNoDescription of the task group
namestringNoName of the task group
remove_assigned_user_group_idsarrayYesUser group IDs to remove from the group, when access_type is Shared. Use GET /it-automation/queri...
remove_assigned_user_idsarrayYesUser IDs to remove from the group, when access_type is Shared. Use GET /user-management/queries/u...
remove_task_idsarrayYesIDs of existing tasks to remove from task group. Get task ids via GET /it-automation/queries/task...

Example:

{
"access_type": "<access_type>",
"add_assigned_user_group_ids": ["<add_assigned_user_group_ids>"],
"add_assigned_user_ids": ["<add_assigned_user_ids>"],
"add_task_ids": ["<add_task_ids>"],
"description": "<description>",
"name": "<name>",
"remove_assigned_user_group_ids": ["<remove_assigned_user_group_ids>"],
"remove_assigned_user_ids": ["<remove_assigned_user_ids>"],
"remove_task_ids": ["<remove_task_ids>"]
}

Itautomation Update User Group

SDK: it_automation.ITAutomationUpdateUserGroup

Parameters:

NameTypeRequiredDescription
add_user_idsarrayYesIDs of the users being added to the user group
descriptionstringNoDescription of the user group
namestringNoName of the user group
remove_user_idsarrayYesIDs of the users being removed from the user group

Example:

{
"add_user_ids": ["<add_user_ids>"],
"description": "<description>",
"name": "<name>",
"remove_user_ids": ["<remove_user_ids>"]
}

List Itautomation Policies

SDK: it_automation.ITAutomationQueryPolicies

Parameters:

NameTypeRequiredDescription
limitnumberNoThe maximum number of ids to return. Defaults to 100 if not specified. The maximum number of resu...
offsetnumberNoThe offset to start retrieving records from. Defaults to 0 if not specified.
platformstringNoThe platform of policies to retrieve
sortstringNoSort the returned ids based on one of the following properties: precedence, created_timestamp...

Example:

{
"limit": 10,
"offset": 10,
"platform": "<platform>",
"sort": "<sort>"
}

List Itautomation Run Live

SDK: it_automation.ITAutomationRunLiveQuery

Parameters:

NameTypeRequiredDescription
composite_queryobjectNoSpecifies task ids and host attributes for composite querying
discover_new_hostsbooleanNoWhether to discover new hosts for the scheduled task. Example: true
discover_offline_hostsbooleanNoWhether to discover offline hosts for the scheduled task. Example: true
distributebooleanNoWhether to distribute the scheduled task. Example: true
expiration_intervalstringNoDuration for which the task stays active. Once expired, new and offline hosts won't be targeted. ...
guardrailsobjectNoExecution guardrails and limits
osquerystringNoOSQuery to execute. Example: select * from users
output_parser_configobjectNoSpecifies columns and delimiter for parsing script execution results
queriesobjectNoScript queries to run per platform
rows_parser_configobjectNoConfiguration for parsing script output into multiple rows
targetstringYesTarget filter in FQL format. Example: platform_name: 'Windows'

Example:

{
"composite_query": {},
"discover_new_hosts": true,
"discover_offline_hosts": true,
"distribute": true,
"expiration_interval": "<expiration_interval>",
"guardrails": {},
"osquery": "<osquery>",
"output_parser_config": {},
"queries": {},
"rows_parser_config": {},
"target": "<target>"
}

List Itautomation Task Executions By

SDK: it_automation.ITAutomationGetTaskExecutionsByQuery

Parameters:

NameTypeRequiredDescription
filterstringNoThe filter expression that should be used to limit the results. Allowed filter fields: [end_time,...
limitnumberNoThe maximum records to return. Example: 50 Default: 100
offsetnumberNoStarting index for record retrieval. Example: 100
sortstringNoThe sort expression that should be used to sort the results. Allowed sort fields: [end_time, run_...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

List Itautomation Task Groups By

SDK: it_automation.ITAutomationGetTaskGroupsByQuery

Parameters:

NameTypeRequiredDescription
filterstringNoThe filter expression that should be used to limit the results. Allowed filter fields: [access_ty...
limitnumberNoThe maximum records to return. Example: 50 Default: 100
offsetnumberNoStarting index for record retrieval. Example: 100
sortstringNoThe sort expression that should be used to sort the results. Allowed sort fields: [access_type, c...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

List Itautomation Tasks By

SDK: it_automation.ITAutomationGetTasksByQuery

Parameters:

NameTypeRequiredDescription
filterstringNoThe filter expression that should be used to limit the results. Allowed filter fields: [access_ty...
limitnumberNoThe maximum records to return. Example: 50 Default: 100
offsetnumberNoStarting index for record retrieval. Example: 100
sortstringNoThe sort expression that should be used to sort the results. Allowed sort fields: [access_type, c...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Lookup Files

Operations for Lookup Files

Operations

OperationNameDescription
create_file_Create FileSDK: lookup_files.CreateFileV1
update_file_Update FileSDK: lookup_files.UpdateFileV1

Create File

SDK: lookup_files.CreateFileV1

Parameters:

NameTypeRequiredDescription
xcsusernamestringNoRequester Username.
xcsuseruuidstringNoRequester UUID.
descriptionstringNoFile description
idstringNoUnique identifier of the file being updated.
namestringNoName used to identify the file
repostringNoName of repository or view to save the file

Example:

{
"xcsusername": "<xcsusername>",
"xcsuseruuid": "<xcsuseruuid>",
"description": "<description>",
"id": "<id>",
"name": "<name>",
"repo": "<repo>"
}

Update File

SDK: lookup_files.UpdateFileV1

Parameters:

NameTypeRequiredDescription
xcsusernamestringNoRequester Username.
xcsuseruuidstringNoRequester UUID.
descriptionstringNoFile description
idstringNoUnique identifier of the file being updated.

Example:

{
"xcsusername": "<xcsusername>",
"xcsuseruuid": "<xcsuseruuid>",
"description": "<description>",
"id": "<id>"
}

Message Center

Operations for Message Center

Operations

OperationNameDescription
aggregate_casesAggregate CasesSDK: message_center.AggregateCases
case_add_activityCase Add ActivitySDK: message_center.CaseAddActivity
case_add_attachmentCase Add AttachmentSDK: message_center.CaseAddAttachment
case_download_attachmentCase Download AttachmentSDK: message_center.CaseDownloadAttachment
create_case_v2Create Case V2SDK: message_center.CreateCaseV2
getGetSDK: message_center.GetCaseEntitiesByIDs
get_case_activity_by_idsGet Case Activity By IdsSDK: message_center.GetCaseActivityByIds
list_activity_by_case_idList Activity By Case IdSDK: message_center.QueryActivityByCaseID
list_cases_ids_by_filterList Cases Ids By FilterSDK: message_center.QueryCasesIdsByFilter

Aggregate Cases

SDK: message_center.AggregateCases

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Case Add Activity

SDK: message_center.CaseAddActivity

Parameters:

NameTypeRequiredDescription
bodystringYesbody. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
case_idstringYescase id. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
typestringYestype. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
user_uuidstringYesuser uuid. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": "<body>",
"case_id": "<case_id>",
"type": "<type>",
"user_uuid": "<user_uuid>"
}

Case Add Attachment

SDK: message_center.CaseAddAttachment

Parameters:

NameTypeRequiredDescription
case_idstringNoCase ID. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
user_uuidstringNoUser UUID. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"case_id": "<case_id>",
"user_uuid": "<user_uuid>"
}

Case Download Attachment

SDK: message_center.CaseDownloadAttachment

Parameters:

NameTypeRequiredDescription
idstringNoattachment ID

Example:

{
"id": "<id>"
}

Create Case V2

SDK: message_center.CreateCaseV2

Parameters:

NameTypeRequiredDescription
bodystringYesbody. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
detectionsobjectYesdetections. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
incidentsobjectYesincidents. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
malware_submission_idstringYesmalware submission id
recon_rule_typestringYesrecon rule type. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
titlestringYestitle. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
typestringYestype. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
user_uuidstringNouser uuid. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": "<body>",
"detections": {},
"incidents": {},
"malware_submission_id": "<malware_submission_id>",
"recon_rule_type": "<recon_rule_type>",
"title": "<title>",
"type": "<type>",
"user_uuid": "<user_uuid>"
}

Get

SDK: message_center.GetCaseEntitiesByIDs

Parameters:

NameTypeRequiredDescription
idsarrayYesids. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"ids": ["<ids>"]
}

Get Case Activity By Ids

SDK: message_center.GetCaseActivityByIds

Parameters:

NameTypeRequiredDescription
idsarrayYesids. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"ids": ["<ids>"]
}

List Activity By Case Id

SDK: message_center.QueryActivityByCaseID

Parameters:

NameTypeRequiredDescription
case_idstringNoCase ID. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
filterstringNoOptional filter and sort criteria in the form of an FQL query. Allowed filters are: activity.crea...
limitnumberNoThe maximum records to return. [1-500]
offsetnumberNoStarting index of overall result set from which to return ids.
sortstringNoThe property to sort on, followed by a dot (.), followed by the sort direction, either "asc" or "...

Example:

{
"case_id": "<case_id>",
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

List Cases Ids By Filter

SDK: message_center.QueryCasesIdsByFilter

Parameters:

NameTypeRequiredDescription
filterstringNocase.assigner.display_name case.assigner.first_name case.assigner.last_name case.assigner.uid cas...
limitnumberNoThe maximum records to return. [1-500]
offsetnumberNoStarting index of overall result set from which to return ids.
sortstringNoThe property to sort on, followed by a dot (.), followed by the sort direction, either "asc" or "...

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Mssp

Operations for Mssp

Operations

OperationNameDescription
add_cidgroup_membersAdd Cidgroup MembersSDK: mssp.AddCIDGroupMembers
add_roleAdd RoleSDK: mssp.AddRole
add_user_group_membersAdd User Group MembersSDK: mssp.AddUserGroupMembers
create_cidgroupsCreate CidgroupsSDK: mssp.CreateCIDGroups
create_user_groupsCreate User GroupsSDK: mssp.CreateUserGroups
delete_cidgroup_membersDelete Cidgroup MembersSDK: mssp.DeleteCIDGroupMembers
delete_cidgroup_members_v2Delete Cidgroup Members V2SDK: mssp.DeleteCIDGroupMembersV2
delete_cidgroupsDelete CidgroupsSDK: mssp.DeleteCIDGroups
delete_d_rolesDelete D RolesSDK: mssp.DeletedRoles
delete_user_group_membersDelete User Group MembersSDK: mssp.DeleteUserGroupMembers
delete_user_groupsDelete User GroupsSDK: mssp.DeleteUserGroups
get_childrenGet ChildrenSDK: mssp.GetChildren
get_children_v2Get Children V2SDK: mssp.GetChildrenV2
get_cidgroup_by_idGet Cidgroup By IdSDK: mssp.GetCIDGroupByID
get_cidgroup_by_idv2Get Cidgroup By Idv2SDK: mssp.GetCIDGroupByIDV2
get_cidgroup_members_byGet Cidgroup Members BySDK: mssp.GetCIDGroupMembersBy
get_cidgroup_members_by_v2Get Cidgroup Members By V2SDK: mssp.GetCIDGroupMembersByV2
get_roles_by_idGet Roles By IdSDK: mssp.GetRolesByID
get_user_group_members_by_idGet User Group Members By IdSDK: mssp.GetUserGroupMembersByID
get_user_group_members_by_idv2Get User Group Members By Idv2SDK: mssp.GetUserGroupMembersByIDV2
get_user_groups_by_idGet User Groups By IdSDK: mssp.GetUserGroupsByID
get_user_groups_by_idv2Get User Groups By Idv2SDK: mssp.GetUserGroupsByIDV2
list_childrenList ChildrenSDK: mssp.QueryChildren
list_cidgroup_membersList Cidgroup MembersSDK: mssp.QueryCIDGroupMembers
list_cidgroupsList CidgroupsSDK: mssp.QueryCIDGroups
list_rolesList RolesSDK: mssp.QueryRoles
list_user_group_membersList User Group MembersSDK: mssp.QueryUserGroupMembers
list_user_groupsList User GroupsSDK: mssp.QueryUserGroups
update_cidgroupsUpdate CidgroupsSDK: mssp.UpdateCIDGroups
update_user_groupsUpdate User GroupsSDK: mssp.UpdateUserGroups

Add Cidgroup Members

SDK: mssp.AddCIDGroupMembers

Parameters:

NameTypeRequiredDescription
resourcesarrayYesBatch operation - array of JSON strings. Each item should be: {"field1":"value1","field2":"value...

Example:

{
"resources": ["<resources>"]
}

Add Role

SDK: mssp.AddRole

Parameters:

NameTypeRequiredDescription
resourcesarrayYesBatch operation - array of JSON strings. Each item should be: {"field1":"value1","field2":"value...

Example:

{
"resources": ["<resources>"]
}

Add User Group Members

SDK: mssp.AddUserGroupMembers

Parameters:

NameTypeRequiredDescription
resourcesarrayYesBatch operation - array of JSON strings. Each item should be: {"field1":"value1","field2":"value...

Example:

{
"resources": ["<resources>"]
}

Create Cidgroups

SDK: mssp.CreateCIDGroups

Parameters:

NameTypeRequiredDescription
resourcesarrayYesBatch operation - array of JSON strings. Each item should be: {"field1":"value1","field2":"value...

Example:

{
"resources": ["<resources>"]
}

Create User Groups

SDK: mssp.CreateUserGroups

Parameters:

NameTypeRequiredDescription
resourcesarrayYesBatch operation - array of JSON strings. Each item should be: {"field1":"value1","field2":"value...

Example:

{
"resources": ["<resources>"]
}

Delete Cidgroup Members

SDK: mssp.DeleteCIDGroupMembers

Parameters:

NameTypeRequiredDescription
resourcesarrayYesBatch operation - array of JSON strings. Each item should be: {"field1":"value1","field2":"value...

Example:

{
"resources": ["<resources>"]
}

Delete Cidgroup Members V2

SDK: mssp.DeleteCIDGroupMembersV2

Parameters:

NameTypeRequiredDescription
resourcesarrayYesBatch operation - array of JSON strings. Each item should be: {"field1":"value1","field2":"value...

Example:

{
"resources": ["<resources>"]
}

Delete Cidgroups

SDK: mssp.DeleteCIDGroups

Parameters:

NameTypeRequiredDescription
cid_group_idsarrayNoCID group ids to delete

Example:

{
"cid_group_ids": ["<cid_group_ids>"]
}

Delete D Roles

SDK: mssp.DeletedRoles

Parameters:

NameTypeRequiredDescription
resourcesarrayYesBatch operation - array of JSON strings. Each item should be: {"field1":"value1","field2":"value...

Example:

{
"resources": ["<resources>"]
}

Delete User Group Members

SDK: mssp.DeleteUserGroupMembers

Parameters:

NameTypeRequiredDescription
resourcesarrayYesBatch operation - array of JSON strings. Each item should be: {"field1":"value1","field2":"value...

Example:

{
"resources": ["<resources>"]
}

Delete User Groups

SDK: mssp.DeleteUserGroups

Parameters:

NameTypeRequiredDescription
user_group_idsarrayNoUser group IDs to delete

Example:

{
"user_group_ids": ["<user_group_ids>"]
}

Get Children

SDK: mssp.GetChildren

Parameters:

NameTypeRequiredDescription
idsarrayNoCID of a child customer

Example:

{
"ids": ["<ids>"]
}

Get Children V2

SDK: mssp.GetChildrenV2

Parameters:

NameTypeRequiredDescription
idsarrayYesids. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"ids": ["<ids>"]
}

Get Cidgroup By Id

SDK: mssp.GetCIDGroupByID

Parameters:

NameTypeRequiredDescription
cid_group_idsarrayNoCID group IDs to be searched on

Example:

{
"cid_group_ids": ["<cid_group_ids>"]
}

Get Cidgroup By Idv2

SDK: mssp.GetCIDGroupByIDV2

Parameters:

NameTypeRequiredDescription
idsarrayNoCID group IDs to search for

Example:

{
"ids": ["<ids>"]
}

Get Cidgroup Members By

SDK: mssp.GetCIDGroupMembersBy

Parameters:

NameTypeRequiredDescription
cid_group_idsarrayNoCID group IDs to search for

Example:

{
"cid_group_ids": ["<cid_group_ids>"]
}

Get Cidgroup Members By V2

SDK: mssp.GetCIDGroupMembersByV2

Parameters:

NameTypeRequiredDescription
idsarrayNoCID group IDs search for

Example:

{
"ids": ["<ids>"]
}

Get Roles By Id

SDK: mssp.GetRolesByID

Parameters:

NameTypeRequiredDescription
idsarrayNoLink ID is a string consisting of multiple components, but should be treated as opaque.

Example:

{
"ids": ["<ids>"]
}

Get User Group Members By Id

SDK: mssp.GetUserGroupMembersByID

Parameters:

NameTypeRequiredDescription
user_group_idsarrayNoUser group IDs to search for

Example:

{
"user_group_ids": ["<user_group_ids>"]
}

Get User Group Members By Idv2

SDK: mssp.GetUserGroupMembersByIDV2

Parameters:

NameTypeRequiredDescription
idsarrayNoUser group IDs to search for

Example:

{
"ids": ["<ids>"]
}

Get User Groups By Id

SDK: mssp.GetUserGroupsByID

Parameters:

NameTypeRequiredDescription
user_group_idsarrayNoUser Group IDs to search for

Example:

{
"user_group_ids": ["<user_group_ids>"]
}

Get User Groups By Idv2

SDK: mssp.GetUserGroupsByIDV2

Parameters:

NameTypeRequiredDescription
idsarrayNoUser group IDs to search for

Example:

{
"ids": ["<ids>"]
}

List Children

SDK: mssp.QueryChildren

Parameters:

NameTypeRequiredDescription
filterstringNoFilter using a query in Falcon Query Language (FQL). Supported filters: cid
limitnumberNoNumber of ids to return Default: 10
offsetnumberNoStarting index of overall result set from which to return ids
sortstringNoThe sort expression used to sort the results Default: "last_modified_timestamp

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

List Cidgroup Members

SDK: mssp.QueryCIDGroupMembers

Parameters:

NameTypeRequiredDescription
cidstringNoCID to lookup associated CID group ID
limitnumberNoMaximum number of results to return Default: 10
offsetnumberNoStarting index of overall result set from which to return id
sortstringNoThe sort expression used to sort the results Default: "last_modified_timestamp

Example:

{
"cid": "<cid>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

List Cidgroups

SDK: mssp.QueryCIDGroups

Parameters:

NameTypeRequiredDescription
limitnumberNoMaximum number of results to return Default: 10
namestringNoName to lookup groups for
offsetnumberNoStarting index of overall result set from which to return ids
sortstringNoThe sort expression used to sort the results Default: "name

Example:

{
"limit": 10,
"name": "<name>",
"offset": 10,
"sort": "<sort>"
}

List Roles

SDK: mssp.QueryRoles

Parameters:

NameTypeRequiredDescription
cid_group_idstringNoCID group ID to fetch MSSP role for
limitnumberNoMaximum number of results to return Default: 10
offsetnumberNoStarting index of overall result set from which to return ids
role_idstringNoRole ID to fetch MSSP role for
sortstringNoThe sort expression used to sort the results Default: "last_modified_timestamp
user_group_idstringNoUser group ID to fetch MSSP role for

Example:

{
"cid_group_id": "<cid_group_id>",
"limit": 10,
"offset": 10,
"role_id": "<role_id>",
"sort": "<sort>",
"user_group_id": "<user_group_id>"
}

List User Group Members

SDK: mssp.QueryUserGroupMembers

Parameters:

NameTypeRequiredDescription
limitnumberNoNumber of ids to return Default: 10
offsetnumberNoStarting index of overall result set from which to return ids
sortstringNoThe sort expression used to sort the results Default: "last_modified_timestamp
user_uuidstringNoUser UUID to lookup associated user group ID

Example:

{
"limit": 10,
"offset": 10,
"sort": "<sort>",
"user_uuid": "<user_uuid>"
}

List User Groups

SDK: mssp.QueryUserGroups

Parameters:

NameTypeRequiredDescription
limitnumberNoMaximum number of results to return Default: 10
namestringNoName to lookup groups for
offsetnumberNoStarting index of overall result set from which to return ids
sortstringNoThe sort expression used to sort the results Default: "name

Example:

{
"limit": 10,
"name": "<name>",
"offset": 10,
"sort": "<sort>"
}

Update Cidgroups

SDK: mssp.UpdateCIDGroups

Parameters:

NameTypeRequiredDescription
resourcesarrayYesBatch operation - array of JSON strings. Each item should be: {"field1":"value1","field2":"value...

Example:

{
"resources": ["<resources>"]
}

Update User Groups

SDK: mssp.UpdateUserGroups

Parameters:

NameTypeRequiredDescription
resourcesarrayYesBatch operation - array of JSON strings. Each item should be: {"field1":"value1","field2":"value...

Example:

{
"resources": ["<resources>"]
}

Ngsiem

Operations for Ngsiem

Operations

OperationNameDescription
create_dashboard_from_templateCreate Dashboard From TemplateSDK: ngsiem.CreateDashboardFromTemplate
create_lookup_fileCreate Lookup FileSDK: ngsiem.CreateLookupFile
create_parserCreate ParserSDK: ngsiem.CreateParser
create_parser_from_templateCreate Parser From TemplateSDK: ngsiem.CreateParserFromTemplate
delete_dashboardDelete DashboardSDK: ngsiem.DeleteDashboard
delete_lookup_fileDelete Lookup FileSDK: ngsiem.DeleteLookupFile
delete_parserDelete ParserSDK: ngsiem.DeleteParser
get_dashboard_templateGet Dashboard TemplateSDK: ngsiem.GetDashboardTemplate
get_lookup_Get LookupSDK: ngsiem.GetLookupV1
get_lookup_fileGet Lookup FileSDK: ngsiem.GetLookupFile
get_lookup_from_package_Get Lookup From PackageSDK: ngsiem.GetLookupFromPackageV1
get_lookup_from_package_with_namespace_Get Lookup From Package With NamespaceSDK: ngsiem.GetLookupFromPackageWithNamespaceV1
get_parserGet ParserSDK: ngsiem.GetParser
get_parser_templateGet Parser TemplateSDK: ngsiem.GetParserTemplate
get_search_status_Get Search StatusSDK: ngsiem.GetSearchStatusV1
list_create_savedList Create SavedSDK: ngsiem.CreateSavedQuery
list_dashboardsList DashboardsSDK: ngsiem.ListDashboards
list_delete_savedList Delete SavedSDK: ngsiem.DeleteSavedQuery
list_lookup_filesList Lookup FilesSDK: ngsiem.ListLookupFiles
list_parsersList ParsersSDK: ngsiem.ListParsers
list_saved_queriesList Saved QueriesSDK: ngsiem.ListSavedQueries
list_saved_templateList Saved TemplateSDK: ngsiem.GetSavedQueryTemplate
list_update_saved_from_templateList Update Saved From TemplateSDK: ngsiem.UpdateSavedQueryFromTemplate
start_search_Start SearchSDK: ngsiem.StartSearchV1
stop_search_Stop SearchSDK: ngsiem.StopSearchV1
update_dashboard_from_templateUpdate Dashboard From TemplateSDK: ngsiem.UpdateDashboardFromTemplate
update_lookup_fileUpdate Lookup FileSDK: ngsiem.UpdateLookupFile
update_parserUpdate ParserSDK: ngsiem.UpdateParser
upload_lookup_Upload LookupSDK: ngsiem.UploadLookupV1

Create Dashboard From Template

SDK: ngsiem.CreateDashboardFromTemplate

Parameters:

NameTypeRequiredDescription
namestringNoname of the dashboard
search_domainstringNoname of search domain (view or repo), options; all, falcon, third-party
yaml_templatestringNoLogScale dashboard YAML template content, see schema at https:schemas.humio.com/

Example:

{
"name": "<name>",
"search_domain": "<search_domain>",
"yaml_template": "<yaml_template>"
}

Create Lookup File

SDK: ngsiem.CreateLookupFile

Parameters:

NameTypeRequiredDescription
filestringNofile content to upload
filenamestringNoFilename of the lookup file to create
search_domainstringNoname of search domain (view or repo), options; all, falcon, third-party, parsers-repository

Example:

{
"file": "<file>",
"filename": "<filename>",
"search_domain": "<search_domain>"
}

Create Parser

SDK: ngsiem.CreateParser

Parameters:

NameTypeRequiredDescription
fields_to_be_removed_before_parsingarrayYesA list of fields that will be removed from the event before it's parsed. These fields will not be...
fields_to_tagarrayYesA list of fields that should be used for sharding. See https:library.humio.com/stable/docs/parser...
namestringYesThe name of parser template
repositorystringYesThe name of the repository where the parser will be created
scriptstringYesThe parser script that transforms the input into events. Humio Language v1
test_casesobjectYesA list of tests that the parser can be tested against

Example:

{
"fields_to_be_removed_before_parsing": ["<fields_to_be_removed_before_parsing>"],
"fields_to_tag": ["<fields_to_tag>"],
"name": "<name>",
"repository": "<repository>",
"script": "<script>",
"test_cases": {}
}

Create Parser From Template

SDK: ngsiem.CreateParserFromTemplate

Parameters:

NameTypeRequiredDescription
namestringNoname of the parser. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/ope...
repositorystringNoname of repository, options; parsers-repository
yaml_templatestringNoLogScale Parser YAML template content, see schema at https:schemas.humio.com/

Example:

{
"name": "<name>",
"repository": "<repository>",
"yaml_template": "<yaml_template>"
}

Delete Dashboard

SDK: ngsiem.DeleteDashboard

Parameters:

NameTypeRequiredDescription
idsstringNodashboard ID value
search_domainstringNoname of search domain (view or repo), options; all, falcon, third-party

Example:

{
"ids": "<ids>",
"search_domain": "<search_domain>"
}

Delete Lookup File

SDK: ngsiem.DeleteLookupFile

Parameters:

NameTypeRequiredDescription
filenamestringNolookup file filename
search_domainstringNoname of search domain (view or repo), options; all, falcon, third-party, parsers-repository

Example:

{
"filename": "<filename>",
"search_domain": "<search_domain>"
}

Delete Parser

SDK: ngsiem.DeleteParser

Parameters:

NameTypeRequiredDescription
idsstringNoparser ID value
repositorystringNoname of repository, options; parsers-repository

Example:

{
"ids": "<ids>",
"repository": "<repository>"
}

Get Dashboard Template

SDK: ngsiem.GetDashboardTemplate

Parameters:

NameTypeRequiredDescription
idsstringNodashboard ID value
search_domainstringNoname of search domain (view or repo), options; all, falcon, third-party, dashboards

Example:

{
"ids": "<ids>",
"search_domain": "<search_domain>"
}

Get Lookup

SDK: ngsiem.GetLookupV1

Parameters:

NameTypeRequiredDescription
filenamestringNoname of lookup file
repositorystringNoname of repository

Example:

{
"filename": "<filename>",
"repository": "<repository>"
}

Get Lookup File

SDK: ngsiem.GetLookupFile

Parameters:

NameTypeRequiredDescription
filenamestringNolookup file filename
search_domainstringNoname of search domain (view or repo), options; all, falcon, third-party, dashboards, parsers-repo...

Example:

{
"filename": "<filename>",
"search_domain": "<search_domain>"
}

Get Lookup From Package

SDK: ngsiem.GetLookupFromPackageV1

Parameters:

NameTypeRequiredDescription
filenamestringNoname of lookup file
packagestringNoname of package
repositorystringNoname of repository

Example:

{
"filename": "<filename>",
"package": "<package>",
"repository": "<repository>"
}

Get Lookup From Package With Namespace

SDK: ngsiem.GetLookupFromPackageWithNamespaceV1

Parameters:

NameTypeRequiredDescription
filenamestringNoname of lookup file
namespacestringNoname of namespace
packagestringNoname of package
repositorystringNoname of repository

Example:

{
"filename": "<filename>",
"namespace": "<namespace>",
"package": "<package>",
"repository": "<repository>"
}

Get Parser

SDK: ngsiem.GetParser

Parameters:

NameTypeRequiredDescription
idsstringNoparser ID value
repositorystringNoname of repository, options; parsers-repository

Example:

{
"ids": "<ids>",
"repository": "<repository>"
}

Get Parser Template

SDK: ngsiem.GetParserTemplate

Parameters:

NameTypeRequiredDescription
idsstringNoparser ID value
repositorystringNoname of repository, options; parsers-repository

Example:

{
"ids": "<ids>",
"repository": "<repository>"
}

Get Search Status

SDK: ngsiem.GetSearchStatusV1

Parameters:

NameTypeRequiredDescription
idstringNoid of query. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
repositorystringNoname of repository

Example:

{
"id": "<id>",
"repository": "<repository>"
}

List Create Saved

SDK: ngsiem.CreateSavedQuery

Parameters:

NameTypeRequiredDescription
search_domainstringNoname of search domain (view or repo), options; all, falcon, third-party
yaml_templatestringNoLogScale Saved Query YAML template content, see schema at https:schemas.humio.com/

Example:

{
"search_domain": "<search_domain>",
"yaml_template": "<yaml_template>"
}

List Dashboards

SDK: ngsiem.ListDashboards

Parameters:

NameTypeRequiredDescription
filterstringNoFQL filter to apply to the name of the content, only currently support text match on name field: ...
limitstringNomaximum number of results to return Default: "50"
offsetstringNonumber of results to offset the returned results by Default: "0"
search_domainstringNoname of search domain (view or repo), options; all, falcon, third-party, dashboards

Example:

{
"filter": "<filter>",
"limit": "<limit>",
"offset": "<offset>",
"search_domain": "<search_domain>"
}

List Delete Saved

SDK: ngsiem.DeleteSavedQuery

Parameters:

NameTypeRequiredDescription
idsstringNosaved query ID value
search_domainstringNoname of search domain (view or repo), options; all, falcon, third-party

Example:

{
"ids": "<ids>",
"search_domain": "<search_domain>"
}

List Lookup Files

SDK: ngsiem.ListLookupFiles

Parameters:

NameTypeRequiredDescription
filterstringNoFQL filter to apply to the name of the content, only currently support text match on name field: ...
limitstringNomaximum number of results to return Default: "50"
offsetstringNonumber of results to offset the returned results by Default: "0"
search_domainstringNoname of search domain (view or repo), options; all, falcon, third-party, dashboards, parsers-repo...

Example:

{
"filter": "<filter>",
"limit": "<limit>",
"offset": "<offset>",
"search_domain": "<search_domain>"
}

List Parsers

SDK: ngsiem.ListParsers

Parameters:

NameTypeRequiredDescription
filterstringNoFQL filter to apply to the name of the content, only currently support text match on name field: ...
limitstringNomaximum number of results to return Default: "50"
offsetstringNonumber of results to offset the returned results by Default: "0"
repositorystringNoname of repository, options; parsers-repository

Example:

{
"filter": "<filter>",
"limit": "<limit>",
"offset": "<offset>",
"repository": "<repository>"
}

List Saved Queries

SDK: ngsiem.ListSavedQueries

Parameters:

NameTypeRequiredDescription
filterstringNoFQL filter to apply to the name of the content, only currently support text match on name field: ...
limitstringNomaximum number of results to return Default: "50"
offsetstringNonumber of results to offset the returned results by Default: "0"
search_domainstringNoname of search domain (view or repo), options; all, falcon, third-party, dashboards

Example:

{
"filter": "<filter>",
"limit": "<limit>",
"offset": "<offset>",
"search_domain": "<search_domain>"
}

List Saved Template

SDK: ngsiem.GetSavedQueryTemplate

Parameters:

NameTypeRequiredDescription
idsstringNosaved query ID value
search_domainstringNoname of search domain (view or repo), options; all, falcon, third-party, dashboards

Example:

{
"ids": "<ids>",
"search_domain": "<search_domain>"
}

List Update Saved From Template

SDK: ngsiem.UpdateSavedQueryFromTemplate

Parameters:

NameTypeRequiredDescription
idsstringNoid of the dashboard
search_domainstringNoname of search domain (view or repo), options; all, falcon, third-party
yaml_templatestringNoLogScale Saved Query YAML template content, see schema at https:schemas.humio.com/

Example:

{
"ids": "<ids>",
"search_domain": "<search_domain>",
"yaml_template": "<yaml_template>"
}

SDK: ngsiem.StartSearchV1

Parameters:

NameTypeRequiredDescription
allowEventSkippingbooleanNoEnables some LogScale functions, such as head() and tail(), to stop processing all data in the se...
aroundobjectNoFind events that occurred around the time of a specific event.
autobucketCountnumberNoThe number of buckets the system should create during live query searches, when no other explicit...
endstringNoThe date and time to use as the ending point of the search results
ingestEndstringNoThe end date and time applied for @ingesttimestamp
ingestStartstringNoThe end date and time applied for @ingesttimestamp
isLivebooleanNoSets whether this query is live. Defaults to false . Live queries are continuously updated.
queryStringstringYesThe CQL query to use for the search
startstringNoThe date and time to use as the starting point of the search results
timeZonestringNoThe time zone to use if start and end times are not specified in milliseconds. Eg: UTC
timeZoneOffsetMinutesnumberNoA positive or negative number representing how many minutes a given time zone is ahead or behind ...
useIngestTimebooleanNoWhen set to true, the event’s ingestStart and ingestEnd times are used as the basis for the que...

Example:

{
"allowEventSkipping": true,
"around": {},
"autobucketCount": 10,
"end": "<end>",
"ingestEnd": "<ingestEnd>",
"ingestStart": "<ingestStart>",
"isLive": true,
"queryString": "<queryString>",
"start": "<start>",
"timeZone": "<timeZone>",
"timeZoneOffsetMinutes": 10,
"useIngestTime": true
}

SDK: ngsiem.StopSearchV1

Parameters:

NameTypeRequiredDescription
idstringNoid of query. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
repositorystringNoname of repository

Example:

{
"id": "<id>",
"repository": "<repository>"
}

Update Dashboard From Template

SDK: ngsiem.UpdateDashboardFromTemplate

Parameters:

NameTypeRequiredDescription
idsstringNoid of the dashboard
search_domainstringNoname of search domain (view or repo), options; all, falcon, third-party
yaml_templatestringNoLogScale dashboard YAML template content, see schema at https:schemas.humio.com/

Example:

{
"ids": "<ids>",
"search_domain": "<search_domain>",
"yaml_template": "<yaml_template>"
}

Update Lookup File

SDK: ngsiem.UpdateLookupFile

Parameters:

NameTypeRequiredDescription
filestringNofile content to upload
filenamestringNoFilename of the lookup file to update
search_domainstringNoname of search domain (view or repo), options; all, falcon, third-party, parsers-repository

Example:

{
"file": "<file>",
"filename": "<filename>",
"search_domain": "<search_domain>"
}

Update Parser

SDK: ngsiem.UpdateParser

Parameters:

NameTypeRequiredDescription
fields_to_be_removed_before_parsingarrayYesA list of fields that will be removed from the event before it's parsed. These fields will not be...
fields_to_tagarrayYesA list of fields that should be used for sharding. See https:library.humio.com/stable/docs/parser...
idstringYesThe unique identifier of the parser to update
repositorystringYesThe name of the repository containing the parser
scriptstringYesThe parser script that transforms the input into events. Humio Language v1
test_casesobjectYesA list of tests that the parser can be tested against

Example:

{
"fields_to_be_removed_before_parsing": ["<fields_to_be_removed_before_parsing>"],
"fields_to_tag": ["<fields_to_tag>"],
"id": "<id>",
"repository": "<repository>",
"script": "<script>",
"test_cases": {}
}

Upload Lookup

SDK: ngsiem.UploadLookupV1

Parameters:

NameTypeRequiredDescription
repositorystringNoname of repository

Example:

{
"repository": "<repository>"
}

Release Notes

Operations for Release Notes

Operations

OperationNameDescription
combined_release_notes_Combined Release NotesSDK: release_notes.CombinedReleaseNotesV1
list_entity_ids_by_postList Entity Ids By PostSDK: release_notes.GetEntityIDsByQueryPOST
list_entity_ids_by_postv2List Entity Ids By Postv2SDK: release_notes.GetEntityIDsByQueryPOSTV2
list_release_notes_List Release NotesSDK: release_notes.QueryReleaseNotesV1

Combined Release Notes

SDK: release_notes.CombinedReleaseNotesV1

Parameters:

NameTypeRequiredDescription
authorizationstringNoauthorization header
xcsusernamestringNouser name
filterstringNoFQL query specifying filter parameters.
limitnumberNoMaximum number of records to return.
offsetstringNoStarting pagination offset of records to return.
sortstringNoSort items by providing a comma separated list of property and direction (eg name.desc,time.asc)....

Example:

{
"authorization": "<authorization>",
"xcsusername": "<xcsusername>",
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

List Entity Ids By Post

SDK: release_notes.GetEntityIDsByQueryPOST

Parameters:

NameTypeRequiredDescription
IDsarrayYesi ds

Example:

{
"IDs": ["<IDs>"]
}

List Entity Ids By Postv2

SDK: release_notes.GetEntityIDsByQueryPOSTV2

Parameters:

NameTypeRequiredDescription
IDsarrayYesi ds

Example:

{
"IDs": ["<IDs>"]
}

List Release Notes

SDK: release_notes.QueryReleaseNotesV1

Parameters:

NameTypeRequiredDescription
authorizationstringNoauthorization header
xcsusernamestringNouser name
filterstringNoFQL query specifying filter parameters.
limitnumberNoMaximum number of records to return.
offsetstringNoStarting pagination offset of records to return.
sortstringNoSort items by providing a comma separated list of property and direction (eg name.desc,time.asc)....

Example:

{
"authorization": "<authorization>",
"xcsusername": "<xcsusername>",
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

Releases

Operations for Releases

Operations

OperationNameDescription
combined_releases_v1mixin0Combined Releases V1Mixin0SDK: releases.CombinedReleasesV1Mixin0

Combined Releases V1Mixin0

SDK: releases.CombinedReleasesV1Mixin0

Parameters:

NameTypeRequiredDescription
authorizationstringNoauthorization header
xcsusernamestringNouser name
filterstringNoFQL query specifying filter parameters.
limitnumberNoMaximum number of records to return.
offsetstringNoStarting pagination offset of records to return.
sortstringNoSort items by providing a comma separated list of property and direction (eg name.desc,time.asc)....

Example:

{
"authorization": "<authorization>",
"xcsusername": "<xcsusername>",
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

Report Executions

Operations for Report Executions

Operations

OperationNameDescription
list_report_executionsList Report ExecutionsSDK: report_executions.ReportExecutionsQuery
report_executions_download_getReport Executions Download GetSDK: report_executions.ReportExecutionsDownloadGet
report_executions_getReport Executions GetSDK: report_executions.ReportExecutionsGet
report_executions_retryReport Executions RetrySDK: report_executions.ReportExecutionsRetry

List Report Executions

SDK: report_executions.ReportExecutionsQuery

Parameters:

NameTypeRequiredDescription
filterstringNoFQL query specifying the filter parameters. Filter term criteria: type, scheduled_report_id, stat...
limitnumberNoNumber of ids to return.
offsetstringNoStarting index of overall result set from which to return ids.
sortstringNoPossible order by fields: created_on, last_updated_on

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

Report Executions Download Get

SDK: report_executions.ReportExecutionsDownloadGet

Parameters:

NameTypeRequiredDescription
idsstringNoThe report_execution id to download

Example:

{
"ids": "<ids>"
}

Report Executions Get

SDK: report_executions.ReportExecutionsGet

Parameters:

NameTypeRequiredDescription
idsarrayNoThe report_execution id to get details about.

Example:

{
"ids": ["<ids>"]
}

Report Executions Retry

SDK: report_executions.ReportExecutionsRetry

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Scheduled Reports

Operations for Scheduled Reports

Operations

OperationNameDescription
executeExecuteSDK: scheduled_reports.Execute
listListSDK: scheduled_reports.Query
list_by_idList By IdSDK: scheduled_reports.QueryByID

Execute

SDK: scheduled_reports.Execute

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

List

SDK: scheduled_reports.Query

Parameters:

NameTypeRequiredDescription
filterstringNoFQL query specifying the filter parameters. Filter term criteria: type, trigger_reference, recipi...
limitnumberNoNumber of ids to return.
offsetstringNoStarting index of overall result set from which to return ids.
sortstringNoPossible order by fields: created_on, last_updated_on, last_execution_on, next_execution_on

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

List By Id

SDK: scheduled_reports.QueryByID

Parameters:

NameTypeRequiredDescription
idsarrayNoThe scheduled_report id to get details about.

Example:

{
"ids": ["<ids>"]
}

Sensor Usage Api

Operations for Sensor Usage Api

Operations

OperationNameDescription
get_sensor_usage_hourlyGet Sensor Usage HourlySDK: sensor_usage_api.GetSensorUsageHourly
get_sensor_usage_weeklyGet Sensor Usage WeeklySDK: sensor_usage_api.GetSensorUsageWeekly

Get Sensor Usage Hourly

SDK: sensor_usage_api.GetSensorUsageHourly

Parameters:

NameTypeRequiredDescription
filterstringNoThe FQL search filter. Allowed fields: "event_date" : A specified date that will be final date of...

Example:

{
"filter": "<filter>"
}

Get Sensor Usage Weekly

SDK: sensor_usage_api.GetSensorUsageWeekly

Parameters:

NameTypeRequiredDescription
filterstringNoThe FQL search filter. Allowed fields: "event_date" : A specified date that will be final date of...

Example:

{
"filter": "<filter>"
}

User Management

Operations for User Management

Operations

OperationNameDescription
aggregate_users_Aggregate UsersSDK: user_management.AggregateUsersV1
combined_user_roles_Combined User RolesSDK: user_management.CombinedUserRolesV1
combined_user_roles_v2Combined User Roles V2SDK: user_management.CombinedUserRolesV2
create_userCreate UserSDK: user_management.CreateUser
create_user_Create UserSDK: user_management.CreateUserV1
delete_userDelete UserSDK: user_management.DeleteUser
delete_user_Delete UserSDK: user_management.DeleteUserV1
entities_roles_Entities RolesSDK: user_management.EntitiesRolesV1
entities_roles_getv2Entities Roles Getv2SDK: user_management.EntitiesRolesGETV2
get_available_role_idsGet Available Role IdsSDK: user_management.GetAvailableRoleIds
get_rolesGet RolesSDK: user_management.GetRoles
get_user_role_idsGet User Role IdsSDK: user_management.GetUserRoleIds
grant_user_role_idsGrant User Role IdsSDK: user_management.GrantUserRoleIds
list_user_List UserSDK: user_management.QueryUserV1
queries_roles_Queries RolesSDK: user_management.QueriesRolesV1
retrieve_emails_by_cidRetrieve Emails By CidSDK: user_management.RetrieveEmailsByCID
retrieve_userRetrieve UserSDK: user_management.RetrieveUser
retrieve_user_uuidRetrieve User UuidSDK: user_management.RetrieveUserUUID
retrieve_user_uuids_by_cidRetrieve User Uuids By CidSDK: user_management.RetrieveUserUUIDsByCID
retrieve_users_getv1Retrieve Users Getv1SDK: user_management.RetrieveUsersGETV1
revoke_user_role_idsRevoke User Role IdsSDK: user_management.RevokeUserRoleIds
update_userUpdate UserSDK: user_management.UpdateUser
update_user_Update UserSDK: user_management.UpdateUserV1
user_action_User ActionSDK: user_management.UserActionV1
user_roles_action_User Roles ActionSDK: user_management.UserRolesActionV1

Aggregate Users

SDK: user_management.AggregateUsersV1

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"body": {}
}

Combined User Roles

SDK: user_management.CombinedUserRolesV1

Parameters:

NameTypeRequiredDescription
cidstringNoCustomer ID to get grants for. Empty CID would result in Role IDs for user against current CID in...
direct_onlybooleanNoSpecifies if to request direct Only role grants or all role grants between user and CID (specifie...
filterstringNoFilter using a query in Falcon Query Language (FQL). Supported filters: expires_at, role_id, role...
limitnumberNoThe maximum records to return. [1-500] Default: 100
offsetnumberNoThe offset to start retrieving records from
sortstringNoThe property to sort by Default: "role_name
user_uuidstringNoUser UUID to get available roles for.

Example:

{
"cid": "<cid>",
"direct_only": true,
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>",
"user_uuid": "<user_uuid>"
}

Combined User Roles V2

SDK: user_management.CombinedUserRolesV2

Parameters:

NameTypeRequiredDescription
cidstringNoCustomer ID to get grants for. Empty CID would result in Role IDs for user against current CID in...
direct_onlybooleanNoSpecifies if to request direct Only role grants or all role grants between user and CID (specifie...
filterstringNoFilter using a query in Falcon Query Language (FQL). Supported filters: expires_at, role_id, role...
limitnumberNoThe maximum records to return. [1-500] Default: 100
offsetnumberNoThe offset to start retrieving records from
sortstringNoThe property to sort by Default: "role_name
user_uuidstringNoUser UUID to get available roles for.

Example:

{
"cid": "<cid>",
"direct_only": true,
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>",
"user_uuid": "<user_uuid>"
}

Create User

SDK: user_management.CreateUser

Parameters:

NameTypeRequiredDescription
firstNamestringNofirst name
lastNamestringNolast name
passwordstringNopassword. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
uidstringNouid. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"firstName": "<firstName>",
"lastName": "<lastName>",
"password": "<password>",
"uid": "<uid>"
}

Create User

SDK: user_management.CreateUserV1

Parameters:

NameTypeRequiredDescription
cidstringNocid. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
first_namestringNofirst name. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
last_namestringNolast name. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
passwordstringNopassword. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
uidstringNouid. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"cid": "<cid>",
"first_name": "<first_name>",
"last_name": "<last_name>",
"password": "<password>",
"uid": "<uid>"
}

Delete User

SDK: user_management.DeleteUser

Parameters:

NameTypeRequiredDescription
user_uuidstringNoID of a user. Find a user's ID from /users/entities/user/v1.

Example:

{
"user_uuid": "<user_uuid>"
}

Delete User

SDK: user_management.DeleteUserV1

Parameters:

NameTypeRequiredDescription
user_uuidstringNoUser UUID.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"user_uuid": "<user_uuid>"
}

Entities Roles

SDK: user_management.EntitiesRolesV1

Parameters:

NameTypeRequiredDescription
cidstringNoCustomer ID to get available roles for. Empty CID would result in Role IDs for current CID in view.
idsarrayNoID of a role. Find a role ID from /user-management/queries/roles/v1.

Example:

{
"cid": "<cid>",
"ids": ["<ids>"]
}

Entities Roles Getv2

SDK: user_management.EntitiesRolesGETV2

Parameters:

NameTypeRequiredDescription
idsarrayYesids. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"ids": ["<ids>"]
}

Get Available Role Ids

SDK: user_management.GetAvailableRoleIds

This operation has no parameters.

Example:

{
}

Get Roles

SDK: user_management.GetRoles

Parameters:

NameTypeRequiredDescription
idsarrayNoID of a role. Find a role ID from /customer/queries/roles/v1 or /users/queries/roles/v1.

Example:

{
"ids": ["<ids>"]
}

Get User Role Ids

SDK: user_management.GetUserRoleIds

Parameters:

NameTypeRequiredDescription
user_uuidstringNoID of a user. Find a user's ID from /users/entities/user/v1.

Example:

{
"user_uuid": "<user_uuid>"
}

Grant User Role Ids

SDK: user_management.GrantUserRoleIds

Parameters:

NameTypeRequiredDescription
roleIdsarrayYesrole ids

Example:

{
"roleIds": ["<roleIds>"]
}

List User

SDK: user_management.QueryUserV1

Parameters:

NameTypeRequiredDescription
filterstringNoFilter using a query in Falcon Query Language (FQL). Supported filters: assigned_cids, cid, direc...
limitnumberNoThe maximum records to return. [1-500] Default: 100
offsetnumberNoThe offset to start retrieving records from
sortstringNoThe property to sort by Default: "uid

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": 10,
"sort": "<sort>"
}

Queries Roles

SDK: user_management.QueriesRolesV1

Parameters:

NameTypeRequiredDescription
actionstringNoActionable purpose of the query Default: "grant"
cidstringNoCustomer ID to get available roles for. Empty CID would result in Role IDs for current CID in view.
user_uuidstringNoUser UUID to get available roles for. Empty User UUID would returns all roles IDs available for c...

Example:

{
"action": "<action>",
"cid": "<cid>",
"user_uuid": "<user_uuid>"
}

Retrieve Emails By Cid

SDK: user_management.RetrieveEmailsByCID

This operation has no parameters.

Example:

{
}

Retrieve User

SDK: user_management.RetrieveUser

Parameters:

NameTypeRequiredDescription
idsarrayNoID of a user. Find a user's ID from /users/entities/user/v1.

Example:

{
"ids": ["<ids>"]
}

Retrieve User Uuid

SDK: user_management.RetrieveUserUUID

Parameters:

NameTypeRequiredDescription
uidarrayNoA username. This is usually the user's email address, but may vary based on your configuration.

Example:

{
"uid": ["<uid>"]
}

Retrieve User Uuids By Cid

SDK: user_management.RetrieveUserUUIDsByCID

This operation has no parameters.

Example:

{
}

Retrieve Users Getv1

SDK: user_management.RetrieveUsersGETV1

Parameters:

NameTypeRequiredDescription
idsarrayYesids. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"ids": ["<ids>"]
}

Revoke User Role Ids

SDK: user_management.RevokeUserRoleIds

Parameters:

NameTypeRequiredDescription
idsarrayNoOne or more role IDs to revoke. Find a role's ID from /users/queries/roles/v1.
user_uuidstringNoID of a user. Find a user's ID from /users/entities/user/v1.

Example:

{
"ids": ["<ids>"],
"user_uuid": "<user_uuid>"
}

Update User

SDK: user_management.UpdateUser

Parameters:

NameTypeRequiredDescription
firstNamestringNofirst name
lastNamestringNolast name

Example:

{
"firstName": "<firstName>",
"lastName": "<lastName>"
}

Update User

SDK: user_management.UpdateUserV1

Parameters:

NameTypeRequiredDescription
first_namestringNofirst name. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
last_namestringNolast name. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"first_name": "<first_name>",
"last_name": "<last_name>"
}

User Action

SDK: user_management.UserActionV1

Parameters:

NameTypeRequiredDescription
actionobjectYesaction. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
idsarrayYesUser ID(s).

Example:

{
"action": {},
"ids": ["<ids>"]
}

User Roles Action

SDK: user_management.UserRolesActionV1

Parameters:

NameTypeRequiredDescription
actionstringNo'grant' or 'revoke'
cidstringNocid. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
expires_atstringNoexpiration date time of the role in RFC3339 format
role_idsarrayYesrole ids. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
uuidstringNouuid. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/

Example:

{
"action": "<action>",
"cid": "<cid>",
"expires_at": "<expires_at>",
"role_ids": ["<role_ids>"],
"uuid": "<uuid>"
}

Workflows

Operations for Workflows

Operations

OperationNameDescription
deprovisionDeprovisionSDK: workflows.Deprovision
executeExecuteSDK: workflows.Execute
execution_actionExecution ActionSDK: workflows.ExecutionAction
execution_resultsExecution ResultsSDK: workflows.ExecutionResults
promotePromoteSDK: workflows.Promote
provisionProvisionSDK: workflows.Provision
workflow_activities_combinedWorkflow Activities CombinedSDK: workflows.WorkflowActivitiesCombined
workflow_activities_content_combinedWorkflow Activities Content CombinedSDK: workflows.WorkflowActivitiesContentCombined
workflow_definitions_actionWorkflow Definitions ActionSDK: workflows.WorkflowDefinitionsAction
workflow_definitions_combinedWorkflow Definitions CombinedSDK: workflows.WorkflowDefinitionsCombined
workflow_definitions_exportWorkflow Definitions ExportSDK: workflows.WorkflowDefinitionsExport
workflow_definitions_importWorkflow Definitions ImportSDK: workflows.WorkflowDefinitionsImport
workflow_definitions_updateWorkflow Definitions UpdateSDK: workflows.WorkflowDefinitionsUpdate
workflow_execute_internalWorkflow Execute InternalSDK: workflows.WorkflowExecuteInternal
workflow_executions_combinedWorkflow Executions CombinedSDK: workflows.WorkflowExecutionsCombined
workflow_get_human_input_Workflow Get Human InputSDK: workflows.WorkflowGetHumanInputV1
workflow_mock_executeWorkflow Mock ExecuteSDK: workflows.WorkflowMockExecute
workflow_triggers_combinedWorkflow Triggers CombinedSDK: workflows.WorkflowTriggersCombined
workflow_update_human_input_Workflow Update Human InputSDK: workflows.WorkflowUpdateHumanInputV1

Deprovision

SDK: workflows.Deprovision

Parameters:

NameTypeRequiredDescription
definition_idstringYesCustomer scoped definition ID that is being deprovisioned. This is required when the template is ...
deprovision_allbooleanYesWhen enabled, the CustomerDefinitionID property is ignored and all template workflows are deprovi...
template_idstringYesID of the system definition template that is to be deprovisioned
template_namestringYesName of the system definition template to deprovision

Example:

{
"definition_id": "<definition_id>",
"deprovision_all": true,
"template_id": "<template_id>",
"template_name": "<template_name>"
}

Execute

SDK: workflows.Execute

Parameters:

NameTypeRequiredDescription
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
definition_idarrayNoDefinition ID to execute, either a name or an ID can be specified.
depthnumberNoUsed to record the execution depth to help limit execution loops when a workflow triggers another...
execution_cidarrayNoCID(s) to execute on. This can be a child if this is a flight control enabled definition. If unse...
keystringNoKey used to help deduplicate executions, if unset a new UUID is used
namestringNoWorkflow name to execute, either a name or an ID can be specified.
source_event_urlstringNoUsed to record a URL to the source that led to triggering this workflow

Example:

{
"body": {},
"definition_id": ["<definition_id>"],
"depth": 10,
"execution_cid": ["<execution_cid>"],
"key": "<key>",
"name": "<name>",
"source_event_url": "<source_event_url>"
}

Execution Action

SDK: workflows.ExecutionAction

Parameters:

NameTypeRequiredDescription
idsarrayYesExecution IDs to perform an action

Example:

{
"ids": ["<ids>"]
}

Execution Results

SDK: workflows.ExecutionResults

Parameters:

NameTypeRequiredDescription
idsarrayNoworkflow execution id to return results for.

Example:

{
"ids": ["<ids>"]
}

Promote

SDK: workflows.Promote

Parameters:

NameTypeRequiredDescription
customer_definition_idstringYesCustomer scoped definition ID that is being promoted. This is required when the template is defin...
namestringYesOptional name to be set on the customer scope definition. Must be unique within a given CID.
parametersobjectYesRuntime parameters to be interpolated to template model
template_idstringYesID of the system definition template that was previously created
template_namestringYesName of the system definition template to provision
template_versionstringYesVersion of system definition template that was previously created, if omitted the latest version ...

Example:

{
"customer_definition_id": "<customer_definition_id>",
"name": "<name>",
"parameters": {},
"template_id": "<template_id>",
"template_name": "<template_name>",
"template_version": "<template_version>"
}

Provision

SDK: workflows.Provision

Parameters:

NameTypeRequiredDescription
namestringYesOptional name to be set on the customer scope definition. Must be unique within a given CID.
parametersobjectYesRuntime parameters to be interpolated to template model
template_idstringYesID of the system definition template that was previously created
template_namestringYesName of the system definition template to provision
template_versionstringYesVersion of system definition template that was previously created, if omitted the latest version ...

Example:

{
"name": "<name>",
"parameters": {},
"template_id": "<template_id>",
"template_name": "<template_name>",
"template_version": "<template_version>"
}

Workflow Activities Combined

SDK: workflows.WorkflowActivitiesCombined

Parameters:

NameTypeRequiredDescription
filterstringNoFQL query specifying filter parameters.
limitnumberNoMaximum number of records to return.
offsetstringNoStarting pagination offset of records to return.
sortstringNoSort items by providing a comma separated list of property and direction (eg name.desc,time.asc)....

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

Workflow Activities Content Combined

SDK: workflows.WorkflowActivitiesContentCombined

Parameters:

NameTypeRequiredDescription
filterstringNoFQL query specifying filter parameters.
limitnumberNoMaximum number of records to return.
offsetstringNoStarting pagination offset of records to return.
sortstringNoSort items by providing a comma separated list of property and direction (eg name.desc,time.asc)....

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

Workflow Definitions Action

SDK: workflows.WorkflowDefinitionsAction

Parameters:

NameTypeRequiredDescription
idsarrayYesExecution IDs to perform an action

Example:

{
"ids": ["<ids>"]
}

Workflow Definitions Combined

SDK: workflows.WorkflowDefinitionsCombined

Parameters:

NameTypeRequiredDescription
filterstringNoFQL query specifying filter parameters.
limitnumberNoMaximum number of records to return.
offsetstringNoStarting pagination offset of records to return.
sortstringNoSort items by providing a comma separated list of property and direction (eg name.desc,time.asc)....

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

Workflow Definitions Export

SDK: workflows.WorkflowDefinitionsExport

Parameters:

NameTypeRequiredDescription
idstringNoID of workflow definitions to return details for
sanitizebooleanNowhether or not to sanitize PII from workflow before it's exported Default: true

Example:

{
"id": "<id>",
"sanitize": true
}

Workflow Definitions Import

SDK: workflows.WorkflowDefinitionsImport

Parameters:

NameTypeRequiredDescription
namestringNoWorkflow name to override
validate_onlybooleanNoWhen enabled, prevents saving workflow after validating

Example:

{
"name": "<name>",
"validate_only": true
}

Workflow Definitions Update

SDK: workflows.WorkflowDefinitionsUpdate

Parameters:

NameTypeRequiredDescription
DefinitionobjectYesdefinition. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
change_logstringNoOptional user provided description to outline the changes made as part of the update. Maximum of ...
enabledbooleanYesSpecifies whether a new definition should be enabled when created, always set to false if it's im...
flight_controlobjectNoChild CID selection parameters for flight control aware workflows
idstringYesUsed to identify documents across versions

Example:

{
"Definition": {},
"change_log": "<change_log>",
"enabled": true,
"flight_control": {},
"id": "<id>"
}

Workflow Execute Internal

SDK: workflows.WorkflowExecuteInternal

Parameters:

NameTypeRequiredDescription
batch_sizenumberNoUsed to set the batchSize, if unset the default batchSize is used
bodyobjectNoBody.. See CrowdStrike API documentation: https://developer.crowdstrike.com/docs/openapi/
definition_idarrayNoDefinition ID to execute, either a name or an ID can be specified.
depthnumberNoUsed to record the execution depth to help limit execution loops when a workflow triggers another...
execution_cidarrayNoCID(s) to execute on. This can be a child if this is a flight control enabled definition. If unse...
keystringNoKey used to help deduplicate executions, if unset a new UUID is used
namestringNoWorkflow name to execute, either a name or an ID can be specified.
source_event_urlstringNoUsed to record a URL to the source that led to triggering this workflow

Example:

{
"batch_size": 10,
"body": {},
"definition_id": ["<definition_id>"],
"depth": 10,
"execution_cid": ["<execution_cid>"],
"key": "<key>",
"name": "<name>",
"source_event_url": "<source_event_url>"
}

Workflow Executions Combined

SDK: workflows.WorkflowExecutionsCombined

Parameters:

NameTypeRequiredDescription
filterstringNoFQL query specifying filter parameters.
limitnumberNoMaximum number of records to return.
offsetstringNoStarting pagination offset of records to return.
sortstringNoSort items by providing a comma separated list of property and direction (eg name.desc,time.asc)....

Example:

{
"filter": "<filter>",
"limit": 10,
"offset": "<offset>",
"sort": "<sort>"
}

Workflow Get Human Input

SDK: workflows.WorkflowGetHumanInputV1

Parameters:

NameTypeRequiredDescription
idsarrayNoIDs of human inputs to read

Example:

{
"ids": ["<ids>"]
}

Workflow Mock Execute

SDK: workflows.WorkflowMockExecute

Parameters:

NameTypeRequiredDescription
definitionobjectNodefinition to be executed with provided mock results and on-demand trigger data
mocksstringYesMock activity data and trigger data for non-on-demand executions, keyed by node ID, may include t...
on_demand_triggerstringNoTrigger data for on-demand executions

Example:

{
"definition": {},
"mocks": "<mocks>",
"on_demand_trigger": "<on_demand_trigger>"
}

Workflow Triggers Combined

SDK: workflows.WorkflowTriggersCombined

Parameters:

NameTypeRequiredDescription
filterstringNoFQL query specifying filter parameters.

Example:

{
"filter": "<filter>"
}

Workflow Update Human Input

SDK: workflows.WorkflowUpdateHumanInputV1

Parameters:

NameTypeRequiredDescription
inputstringYesinput to provide to the user input activity
notestringYesnote added to user input at the time an input is provided

Example:

{
"input": "<input>",
"note": "<note>"
}

Best Practices

  1. Use Appropriate Filters: Leverage FQL (Falcon Query Language) filters to narrow down results and improve performance.

  2. Implement Pagination: For operations returning large datasets, use limit and offset parameters to paginate results.

  3. Handle Rate Limits: CrowdStrike APIs have rate limits. Implement appropriate delays and retry logic in your workflows.

  4. Secure Credentials: Never log or expose API credentials. Use NINA's credential management for secure storage.

  5. Use Specific Scopes: When creating API clients, only request the minimum required API scopes.

  6. Monitor API Usage: Track your API usage to avoid hitting rate limits during critical operations.

  7. Validate IDs: Always validate resource IDs before using them in update or delete operations.

  8. Error Handling: Implement comprehensive error handling for API failures and unexpected responses.

Troubleshooting

IssuePossible Solution
401 UnauthorizedVerify Client ID and Client Secret are correct; check if credentials have expired
403 ForbiddenEnsure API client has required scopes for the operation
404 Not FoundVerify the resource ID exists and is accessible with your credentials
429 Too Many RequestsRate limit exceeded; implement delays between requests
Invalid FilterCheck FQL syntax; refer to CrowdStrike FQL documentation
Connection TimeoutVerify network connectivity and correct Base URL for your region
Empty ResultsVerify filter criteria; check if resources exist in your environment

Support

For issues with this integration, please contact support with:

  • The operation you were attempting
  • Any error messages received
  • The parameters used (excluding sensitive data)
  • Your CrowdStrike cloud region

For CrowdStrike API documentation, visit: CrowdStrike Developer Portal

Updated: 2026-02-05