Overview
Real-time Response (RTR) policies control the level of access administrators have when performing remote operations on endpoints. These policies determine which RTR commands are available for incident response and system management tasks.Required API Scope:
Response policies: Read (for read operations) or Response policies: Write (for write operations)Get Response Policies
Search for and retrieve Real-time Response policies.Get-FalconResponsePolicy
Parameters
string[]
Policy identifier(s). Pattern:
^[a-fA-F0-9]{32}$string
Falcon Query Language (FQL) expression to limit resultsExample:
platform_name:'Windows'+enabled:truestring
Property and direction to sort resultsValid values:
created_by.asc, created_by.desc, created_timestamp.asc, created_timestamp.desc, enabled.asc, enabled.desc, modified_by.asc, modified_by.desc, modified_timestamp.asc, modified_timestamp.desc, name.asc, name.desc, platform_name.asc, platform_name.desc, precedence.asc, precedence.descint32
Maximum number of results per request (1-5000)
string[]
Include additional propertiesValid values:
membersint32
Position to begin retrieving results
switch
Retrieve detailed information
switch
Repeat requests until all available results are retrieved
switch
Display total result count instead of results
Examples
Create Response Policy
Create new Real-time Response policies.New-FalconResponsePolicy
Parameters
string
required
Policy name
string
required
Operating system platformValid values:
Windows, Mac, Linuxstring
Policy description
object[]
Policy settings controlling RTR capabilities. Each setting should include
id and value properties.object[]
One or more policies to create in a single request (for batch operations, max 100 per request)
Examples
Edit Response Policy
Modify existing Real-time Response policies.Edit-FalconResponsePolicy
Parameters
string
required
Policy identifier. Pattern:
^[a-fA-F0-9]{32}$string
Policy name
string
Policy description
object[]
Policy settings to update. Each setting should contain
id and value.object[]
One or more policies to modify in a single request (for batch operations, max 100 per request)
Examples
Remove Response Policy
Remove Real-time Response policies.Remove-FalconResponsePolicy
Parameters
string[]
required
Policy identifier(s) to remove. Pattern:
^[a-fA-F0-9]{32}$Example
Policy Actions
Perform actions on Real-time Response policies such as enabling/disabling or assigning to host groups.Invoke-FalconResponsePolicyAction
Parameters
string
required
Action to performValid values:
add-host-group, disable, enable, remove-host-groupstring
Host group identifier. Pattern:
^[a-fA-F0-9]{32}$Required for: add-host-group, remove-host-groupstring
required
Policy identifier. Pattern:
^[a-fA-F0-9]{32}$Examples
Get Policy Members
Search for members (hosts) assigned to Real-time Response policies.Get-FalconResponsePolicyMember
Parameters
string
Policy identifier. Pattern:
^[a-fA-F0-9]{32}$string
Falcon Query Language expression to limit results
string
Property and direction to sort results
int32
Maximum number of results per request (1-5000)
int32
Position to begin retrieving results
switch
Retrieve detailed information
switch
Repeat requests until all available results are retrieved
switch
Display total result count instead of results
Example
Set Policy Precedence
Set Real-time Response policy precedence order for a specific platform.Set-FalconResponsePrecedence
Parameters
string
required
Operating system platformValid values:
Windows, Mac, Linuxstring[]
required
Policy identifiers in desired precedence order (highest to lowest priority). Pattern:
^[a-fA-F0-9]{32}$All policy identifiers must be supplied in order, with the exception of the
platform_default policy.Example
RTR Policy Settings
Real-time Response policies control which commands are available during RTR sessions. Common settings include:- Basic Commands: Always available (e.g.,
ls,cd,ps) - Get Commands: File retrieval from endpoints
- Put Commands: File upload to endpoints
- RunScript Commands: Execute scripts on endpoints
- Admin Commands: Advanced system commands (e.g., registry modifications)
Related Resources
Prevention Policies
Manage Prevention policies
Firewall Policies
Configure firewall rules and policies