Overview
The Sample Files API allows you to upload suspicious files to CrowdStrike for analysis, download previously submitted samples, and manage sample file metadata. Samples can be submitted for analysis using Falcon Sandbox or Falcon QuickScan.All sample operations require Sample uploads: Read or Sample uploads: Write permissions.
Get-FalconSample
Retrieve detailed information about accessible sample files using SHA256 hash values.Syntax
Parameters
SHA256 hash value(s) of the sample file(s). Must be 64-character hexadecimal strings.Aliases:
sha256s, sha256, idsExamples
Returns
Detailed information about the sample file including SHA256 hash, file size, file type, and analysis status.Send-FalconSample
Upload a sample file to CrowdStrike for analysis. Maximum file size is 256MB.Syntax
Parameters
Path to the local file to upload. The file must exist and cannot be a directory.Aliases:
body, FullNameProhibit the sample from being displayed in MalQuery. Default is
True to keep samples confidential.Aliases: is_confidentialAudit log comment describing the reason for the upload or additional context.
File name to use for the sample. If not specified, the local file name is used.Aliases:
file_name, FileNameExamples
Returns
Upload confirmation with SHA256 hash that can be used for Falcon Sandbox or QuickScan submissions.Receive-FalconSample
Download a previously submitted sample file from CrowdStrike.Syntax
Parameters
Destination path where the sample file will be saved.
SHA256 hash value of the sample to download. Must be 64-character hexadecimal string.Aliases:
idsArchive and password protect the sample with password
infected.Aliases: password_protectedOverwrite an existing file when present at the destination path.
Examples
Remove-FalconSample
Remove a sample from your CrowdStrike environment.Syntax
Parameters
SHA256 hash value of the sample to remove. Must be 64-character hexadecimal string.Aliases:
ids, sha256Examples
Common Workflows
Upload and Analyze Sample
Download Multiple Samples
Batch Upload Samples
Permissions Required
| Operation | Permission |
|---|---|
| Get-FalconSample | Sample uploads: Read |
| Send-FalconSample | Sample uploads: Write |
| Receive-FalconSample | Sample uploads: Read |
| Remove-FalconSample | Sample uploads: Write |
Related Commands
Submit-FalconSandbox- Submit samples for sandbox analysisGet-FalconQuickScan- Submit samples for quick scanningGet-FalconMalQuery- Search for similar samples in MalQuery