Skip to content

Correlation Rules

The Correlation Rules service collection provides operations for managing correlation rules and templates. Create, update, delete, and query correlation rules. Export and import rule versions, publish rule versions, and manage rule templates.

LanguageLast Update
Pythonv1.6.5
PowerShellv2.2.9
Gov0.22.0
TypeScriptv0.6.0
Rustv0.7.1
Rubyv1.4.0


OperationDescription
aggregates.rule-versions.post.v1
aggregate_rule_versions
Get rules aggregates as specified via json in the request body.
combined.rules.get.v1
get_rules_combined
Find all rules matching the query and filter.
combined.rules.get.v2
get_rules_combined_v2
Find all rules matching the query and filter.
entities.latest-rules.get.v1
get_latest_rule_versions
Retrieve latest rule versions by rule IDs
entities.rule-versions.delete.v1
delete_rule_versions
Delete versions by IDs
entities.rule-versions_export.post.v1
export_rule
Export rule versions
entities.rule-versions_import.post.v1
import_rule
Import rule versions
entities.rule-versions_publish.patch.v1
publish_rule_version
Publish existing rule version
entities.rules.delete.v1
delete_rules
Delete rules by IDs
entities.rules.get.v1
get_rules
Retrieve rules by IDs
entities.rules.get.v2
get_rules_v2
Retrieve rule versions by IDs
entities.rules.patch.v1
update_rule
Update rules
entities.rules.post.v1
create_rule
Create rule
entities.templates.get.v1Mixin0
get_rule_templates_by_id
Retrieve rule templates by IDs
entities.templates_rules.post.v1
create_rule_from_template
Create rule from template
queries.rules.get.v1
query_rules
Find all rule IDs matching the query and filter.
queries.rules.get.v2
query_rules_v2
Find all rule version IDs matching the query and filter.
queries.templates.get.v1Mixin0
search_rule_template_ids
Search rule template IDs matching the filter.

Get rules aggregates as specified via json in the request body.

Method POST
Route /correlation-rules/aggregates/rule-versions/v1
Scope Correlation Rules: WRITE
PEP 8 aggregate_rule_versions
body body · dictionary
Full body payload as JSON formatted dictionary.
ids query · string or list of strings
The IDs
filter query · string
FQL query specifying the filter parameters.
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
id_list = 'ID1,ID2,ID3' # Can also pass a list here: ['ID1', 'ID2', 'ID3']
response = falcon.aggregate_rule_versions(filter="string", ids=id_list)
print(response)
[
{
"buckets": [],
"doc_count_error_upper_bound": 0,
"hits": {},
"name": "string",
"sum_other_doc_count": 0
}
]


Find all rules matching the query and filter.

Method GET
Route /correlation-rules/combined/rules/v1
Scope Correlation Rules: READ
PEP 8 get_rules_combined
filter query · string
FQL query specifying the filter parameters
Available values (9)
customer_iduser_iduser_uuid
statusnamecreated_on
last_updated_oncreated_onlast_updated_on
q query · string
Match query criteria, which includes all the filter string fields
sort query · string
Rule property to sort on.
Available values (4)
created_oncreated_on|desclast_updated_on
last_updated_on|desc
offset query · integer
Starting index of overall result set from which to return IDs
limit query · integer
Number of IDs to return
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.get_rules_combined(filter="string",
q="string",
sort="string",
offset=integer,
limit=integer)
print(response)
[
{
"anomaly": {},
"api_client_id": "string",
"author": "string",
"comment": "string",
"created_on": "string",
"customer_id": "string",
"description": "string",
"executor_rule_id": "string",
"guardrail_notifications": [],
"id": "string",
"last_execution": {},
"last_updated_on": "string",
"mitre_attack": [],
"name": "string",
"next_execution_on": "string",
"notifications": [],
"operation": {},
"rule_id": "string",
"search": {},
"severity": 0,
"state": "string",
"status": "string",
"status_msg": "string",
"tactic": "string",
"technique": "string",
"template_id": "string",
"type": "string",
"updated_by_api_client_id": "string",
"updated_by_user_id": "string",
"updated_by_user_uuid": "string",
"user_id": "string",
"user_uuid": "string",
"version": 0
}
]


Find all rules matching the query and filter.

Method GET
Route /correlation-rules/combined/rules/v2
Scope Correlation Rules: READ
PEP 8 get_rules_combined_v2
filter query · string
FQL query specifying the filter parameters
Available values (9)
customer_iduser_iduser_uuid
statusnamecreated_on
last_updated_oncreated_onlast_updated_on
q query · string
Match query criteria, which includes all the filter string fields
sort query · string
Rule property to sort on.
Available values (4)
created_oncreated_on|desclast_updated_on
last_updated_on|desc
offset query · integer
Starting index of overall result set from which to return IDs
limit query · integer
Number of IDs to return
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.get_rules_combined_v2(filter="string",
q="string",
sort="string",
offset=integer,
limit=integer)
print(response)
[
{
"anomaly": {},
"api_client_id": "string",
"author": "string",
"comment": "string",
"created_on": "string",
"customer_id": "string",
"description": "string",
"executor_rule_id": "string",
"guardrail_notifications": [],
"id": "string",
"last_execution": {},
"last_updated_on": "string",
"mitre_attack": [],
"name": "string",
"next_execution_on": "string",
"notifications": [],
"operation": {},
"rule_id": "string",
"search": {},
"severity": 0,
"state": "string",
"status": "string",
"status_msg": "string",
"tactic": "string",
"technique": "string",
"template_id": "string",
"type": "string",
"updated_by_api_client_id": "string",
"updated_by_user_id": "string",
"updated_by_user_uuid": "string",
"user_id": "string",
"user_uuid": "string",
"version": 0
}
]


Retrieve latest rule versions by rule IDs

Method GET
Route /correlation-rules/entities/latest-rules/v1
Scope Correlation Rules: READ
PEP 8 get_latest_rule_versions
rule_ids query · string or list of strings
The rule IDs
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
id_list = 'ID1,ID2,ID3' # Can also pass a list here: ['ID1', 'ID2', 'ID3']
response = falcon.get_latest_rule_versions(rule_ids=id_list)
print(response)
[
{
"anomaly": {},
"api_client_id": "string",
"author": "string",
"comment": "string",
"created_on": "string",
"customer_id": "string",
"description": "string",
"executor_rule_id": "string",
"guardrail_notifications": [],
"id": "string",
"last_execution": {},
"last_updated_on": "string",
"mitre_attack": [],
"name": "string",
"next_execution_on": "string",
"notifications": [],
"operation": {},
"rule_id": "string",
"search": {},
"severity": 0,
"state": "string",
"status": "string",
"status_msg": "string",
"tactic": "string",
"technique": "string",
"template_id": "string",
"type": "string",
"updated_by_api_client_id": "string",
"updated_by_user_id": "string",
"updated_by_user_uuid": "string",
"user_id": "string",
"user_uuid": "string",
"version": 0
}
]


Delete versions by IDs

Method DELETE
Route /correlation-rules/entities/rule-versions/v1
Scope Correlation Rules: WRITE
PEP 8 delete_rule_versions
ids query · string or list of strings
The IDs
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
id_list = 'ID1,ID2,ID3' # Can also pass a list here: ['ID1', 'ID2', 'ID3']
response = falcon.delete_rule_versions(ids=id_list)
print(response)
[
"string"
]


Export rule versions

Method POST
Route /correlation-rules/entities/rule-versions/export/v1
Scope Correlation Rules: WRITE
PEP 8 export_rule
body body · dictionary
Full body payload as JSON formatted dictionary.
get_latest body · boolean
Flag indicating if the latest rule version should be exported.
report_format body · string
Format to use for rule export.
search body · object
Rule search to perform. Overrides filter and sort keywords.
filter body · string
Filter to use to filter rules.
sort body · string
Sort to use for rule export.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
search = {
"filter": "string",
"sort": "string"
}
response = falcon.export_rule(filter="string",
get_latest=boolean,
report_format="string",
search=search,
sort="string")
print(response)
[
{
"href": "string",
"id": "string"
}
]


Import rule versions

Method POST
Route /correlation-rules/entities/rule-versions/import/v1
Scope Correlation Rules: WRITE
PEP 8 import_rule
rule body · dictionary
Rule to be imported.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.import_rule(rule={})
print(response)
[
{
"anomaly": {},
"api_client_id": "string",
"author": "string",
"comment": "string",
"created_on": "string",
"customer_id": "string",
"description": "string",
"executor_rule_id": "string",
"guardrail_notifications": [],
"id": "string",
"last_execution": {},
"last_updated_on": "string",
"mitre_attack": [],
"name": "string",
"next_execution_on": "string",
"notifications": [],
"operation": {},
"rule_id": "string",
"search": {},
"severity": 0,
"state": "string",
"status": "string",
"status_msg": "string",
"tactic": "string",
"technique": "string",
"template_id": "string",
"type": "string",
"updated_by_api_client_id": "string",
"updated_by_user_id": "string",
"updated_by_user_uuid": "string",
"user_id": "string",
"user_uuid": "string",
"version": 0
}
]


Publish existing rule version

Method PATCH
Route /correlation-rules/entities/rule-versions/publish/v1
Scope Correlation Rules: WRITE
PEP 8 publish_rule_version
body body · dictionary
Full body payload as JSON formatted dictionary.
id body · string
Correlation rule version ID to be published.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.publish_rule_version(id="string")
print(response)
[
{
"anomaly": {},
"api_client_id": "string",
"author": "string",
"comment": "string",
"created_on": "string",
"customer_id": "string",
"description": "string",
"executor_rule_id": "string",
"guardrail_notifications": [],
"id": "string",
"last_execution": {},
"last_updated_on": "string",
"mitre_attack": [],
"name": "string",
"next_execution_on": "string",
"notifications": [],
"operation": {},
"rule_id": "string",
"search": {},
"severity": 0,
"state": "string",
"status": "string",
"status_msg": "string",
"tactic": "string",
"technique": "string",
"template_id": "string",
"type": "string",
"updated_by_api_client_id": "string",
"updated_by_user_id": "string",
"updated_by_user_uuid": "string",
"user_id": "string",
"user_uuid": "string",
"version": 0
}
]


Delete rules by IDs

Method DELETE
Route /correlation-rules/entities/rules/v1
Scope Correlation Rules: WRITE
PEP 8 delete_rules
ids query · string or list of strings
The IDs
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
id_list = 'ID1,ID2,ID3' # Can also pass a list here: ['ID1', 'ID2', 'ID3']
response = falcon.delete_rules(ids=id_list)
print(response)
[
"string"
]


Retrieve rules by IDs

Method GET
Route /correlation-rules/entities/rules/v1
Scope Correlation Rules: READ
PEP 8 get_rules
ids query · string or list of strings
The IDs
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
id_list = 'ID1,ID2,ID3' # Can also pass a list here: ['ID1', 'ID2', 'ID3']
response = falcon.get_rules(ids=id_list)
print(response)
[
{
"anomaly": {},
"api_client_id": "string",
"author": "string",
"comment": "string",
"created_on": "string",
"customer_id": "string",
"description": "string",
"executor_rule_id": "string",
"guardrail_notifications": [],
"id": "string",
"last_execution": {},
"last_updated_on": "string",
"mitre_attack": [],
"name": "string",
"next_execution_on": "string",
"notifications": [],
"operation": {},
"rule_id": "string",
"search": {},
"severity": 0,
"state": "string",
"status": "string",
"status_msg": "string",
"tactic": "string",
"technique": "string",
"template_id": "string",
"type": "string",
"updated_by_api_client_id": "string",
"updated_by_user_id": "string",
"updated_by_user_uuid": "string",
"user_id": "string",
"user_uuid": "string",
"version": 0
}
]


Retrieve rule versions by IDs

Method GET
Route /correlation-rules/entities/rules/v2
Scope Correlation Rules: READ
PEP 8 get_rules_v2
ids query · string or list of strings
The IDs
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
id_list = 'ID1,ID2,ID3' # Can also pass a list here: ['ID1', 'ID2', 'ID3']
response = falcon.get_rules_v2(ids=id_list)
print(response)
[
{
"anomaly": {},
"api_client_id": "string",
"author": "string",
"comment": "string",
"created_on": "string",
"customer_id": "string",
"description": "string",
"executor_rule_id": "string",
"guardrail_notifications": [],
"id": "string",
"last_execution": {},
"last_updated_on": "string",
"mitre_attack": [],
"name": "string",
"next_execution_on": "string",
"notifications": [],
"operation": {},
"rule_id": "string",
"search": {},
"severity": 0,
"state": "string",
"status": "string",
"status_msg": "string",
"tactic": "string",
"technique": "string",
"template_id": "string",
"type": "string",
"updated_by_api_client_id": "string",
"updated_by_user_id": "string",
"updated_by_user_uuid": "string",
"user_id": "string",
"user_uuid": "string",
"version": 0
}
]


Update rules

Method PATCH
Route /correlation-rules/entities/rules/v1
Scope Correlation Rules: WRITE
PEP 8 update_rule
body body · dictionary
Full body payload as JSON formatted dictionary.
anomaly body · object
Anomaly detection configuration.
comment body · string
Correlation rule comment.
description body · string
Correlation rule description.
guardrail_notifications body · array
List of guardrail notifications.
id body · string
Correlation rule ID to be updated.
mitre_attack body · array
List of MITRE ATT&CK tactic and technique mappings.
name body · string
Correlation rule name.
notifications body · array
List of notifications to implement.
operation body · object
Operation to perform.
search body · object
Search to perform.
severity body · integer
Correlation severity.
state body · string
status body · string
Correlation rule status.
tactic body · string
Identified tactic.
technique body · string
Identified technique.
customer_id body · string
CID for the tenant.
template_id body · string
Template identifier to base the rule on.
trigger_on_create body · boolean
Flag indicating if the rule triggers on creation.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
anomaly = {
"event_field_name": "string",
"lookback_timeframe": "string",
"scope": "string",
"type": "string",
"use_established_entity_only": "boolean"
}
guardrail_notifications = [
{
"config": {
"cid": "string",
"config_id": "string",
"plugin_id": "string",
"recipients": [
"string"
],
"severity": "string"
},
"options": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
},
"type": "string"
}
]
mitre_attack = [
{
"tactic_id": "string",
"technique_id": "string"
}
]
notifications = [
{
"config": {
"cid": "string",
"config_id": "string",
"plugin_id": "string",
"recipients": [
"string"
],
"severity": "string"
},
"options": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
},
"type": "string"
}
]
operation = {
"schedule": {
"definition": "string"
},
"start_on": "2026-04-17T16:10:23.160Z",
"stop_on": "2026-04-17T16:10:23.160Z",
"suppression": {
"filter": {
"field_based": {
"field": "string"
}
},
"suppression_period": "string"
}
}
search = {
"case_template_id": "string",
"execution_mode": "string",
"filter": "string",
"lookback": "string",
"outcome": "string",
"trigger_mode": "string",
"use_ingest_time": "boolean"
}
response = falcon.update_rule(anomaly=anomaly,
comment="string",
customer_id="string",
description="string",
guardrail_notifications=guardrail_notifications,
id="string",
mitre_attack=mitre_attack,
name="string",
notifications=notifications,
operation=operation,
search=search,
severity=integer,
status="string",
tactic="string",
technique="string",
template_id="string",
trigger_on_create=boolean)
print(response)
[
{
"anomaly": {},
"api_client_id": "string",
"author": "string",
"comment": "string",
"created_on": "string",
"customer_id": "string",
"description": "string",
"executor_rule_id": "string",
"guardrail_notifications": [],
"id": "string",
"last_execution": {},
"last_updated_on": "string",
"mitre_attack": [],
"name": "string",
"next_execution_on": "string",
"notifications": [],
"operation": {},
"rule_id": "string",
"search": {},
"severity": 0,
"state": "string",
"status": "string",
"status_msg": "string",
"tactic": "string",
"technique": "string",
"template_id": "string",
"type": "string",
"updated_by_api_client_id": "string",
"updated_by_user_id": "string",
"updated_by_user_uuid": "string",
"user_id": "string",
"user_uuid": "string",
"version": 0
}
]


Create rule

Method POST
Route /correlation-rules/entities/rules/v1
Scope Correlation Rules: WRITE
PEP 8 create_rule
body body · dictionary
Full body payload as JSON formatted dictionary.
anomaly body · object
Anomaly detection configuration.
comment body · string
Correlation rule comment.
customer_id body · string
CID for the tenant.
description body · string
Correlation rule description.
guardrail_notifications body · array
List of guardrail notifications.
mitre_attack body · array
List of MITRE ATT&CK tactic and technique mappings.
name body · string
Correlation rule name.
notifications body · array
List of notifications to implement.
operation body · object
Operation to perform.
search body · object
Search to perform.
severity body · integer
Correlation severity.
status body · string
Correlation rule status.
tactic body · string
Identified tactic.
technique body · string
Identified technique.
template_id body · string
Template identifier to base the rule on.
trigger_on_create body · boolean
Flag indicating if the rule triggers on creation.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
anomaly = {
"event_field_name": "string",
"lookback_timeframe": "string",
"scope": "string",
"type": "string",
"use_established_entity_only": "boolean"
}
guardrail_notifications = [
{
"config": {
"cid": "string",
"config_id": "string",
"plugin_id": "string",
"recipients": [
"string"
],
"severity": "string"
},
"options": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
},
"type": "string"
}
]
mitre_attack = [
{
"tactic_id": "string",
"technique_id": "string"
}
]
notifications = [
{
"config": {
"cid": "string",
"config_id": "string",
"plugin_id": "string",
"recipients": [
"string"
],
"severity": "string"
},
"options": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
},
"type": "string"
}
]
operation = {
"schedule": {
"definition": "string"
},
"start_on": "2026-04-17T16:10:23.160Z",
"stop_on": "2026-04-17T16:10:23.160Z",
"suppression": {
"filter": {
"field_based": {
"field": "string"
}
},
"suppression_period": "string"
}
}
search = {
"case_template_id": "string",
"execution_mode": "string",
"filter": "string",
"lookback": "string",
"outcome": "string",
"trigger_mode": "string",
"use_ingest_time": "boolean"
}
response = falcon.create_rule(anomaly=anomaly,
comment="string",
customer_id="string",
description="string",
guardrail_notifications=guardrail_notifications,
mitre_attack=mitre_attack,
name="string",
notifications=notifications,
operation=operation,
search=search,
severity=integer,
status="string",
tactic="string",
technique="string",
template_id="string",
trigger_on_create=boolean)
print(response)
[
{
"anomaly": {},
"api_client_id": "string",
"author": "string",
"comment": "string",
"created_on": "string",
"customer_id": "string",
"description": "string",
"executor_rule_id": "string",
"guardrail_notifications": [],
"id": "string",
"last_execution": {},
"last_updated_on": "string",
"mitre_attack": [],
"name": "string",
"next_execution_on": "string",
"notifications": [],
"operation": {},
"rule_id": "string",
"search": {},
"severity": 0,
"state": "string",
"status": "string",
"status_msg": "string",
"tactic": "string",
"technique": "string",
"template_id": "string",
"type": "string",
"updated_by_api_client_id": "string",
"updated_by_user_id": "string",
"updated_by_user_uuid": "string",
"user_id": "string",
"user_uuid": "string",
"version": 0
}
]


Retrieve rule templates by IDs

Method GET
Route /correlation-rules/entities/templates/v1
Scope Correlation Rules: READ
PEP 8 get_rule_templates_by_id
ids query · string or list of strings
The IDs
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
id_list = 'ID1,ID2,ID3' # Can also pass a list here: ['ID1', 'ID2', 'ID3']
response = falcon.get_rule_templates_by_id(ids=id_list)
print(response)
[
{
"author": "string",
"created_on": "string",
"description": "string",
"id": "string",
"last_updated_on": "string",
"license_details": {},
"mitre_attack": [],
"name": "string",
"operation": {},
"search": {},
"severity": 0,
"type": "string",
"vendors": []
}
]


Create rule from template

Method POST
Route /correlation-rules/entities/templates/rules/v1
Scope Correlation Rules: WRITE
PEP 8 create_rule_from_template
body body · dictionary
Full body payload as JSON formatted dictionary.
customer_id body · string
Customer ID for the rule template.
templates body · array
List of rule template definitions to create rules from.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
templates = [
{
"comment": "string",
"description": "string",
"guardrail_notifications": [
{
"config": {
"cid": "string",
"config_id": "string",
"plugin_id": "string",
"recipients": [
"string"
],
"severity": "string"
},
"options": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
},
"type": "string"
}
],
"mitre_attack": [
{
"tactic_id": "string",
"technique_id": "string"
}
],
"name": "string",
"notifications": [
{
"config": {
"cid": "string",
"config_id": "string",
"plugin_id": "string",
"recipients": [
"string"
],
"severity": "string"
},
"options": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
},
"type": "string"
}
],
"operation": {
"schedule": {
"definition": "string"
},
"start_on": "2026-02-04T21:13:29.753Z",
"stop_on": "2026-02-04T21:13:29.753Z",
"suppression": {
"filter": {
"field_based": {
"field": "string"
}
},
"suppression_period": "string"
}
},
"search": {
"case_template_id": "string",
"execution_mode": "string",
"filter": "string",
"lookback": "string",
"outcome": "string",
"trigger_mode": "string",
"use_ingest_time": True
},
"severity": 0,
"status": "string",
"template_id": "string",
"trigger_on_create": True
}
]
response = falcon.create_rule_from_template(customer_id="string",
templates=templates)
print(response)
[
{
"anomaly": {},
"api_client_id": "string",
"author": "string",
"comment": "string",
"created_on": "string",
"customer_id": "string",
"description": "string",
"executor_rule_id": "string",
"guardrail_notifications": [],
"id": "string",
"last_execution": {},
"last_updated_on": "string",
"mitre_attack": [],
"name": "string",
"next_execution_on": "string",
"notifications": [],
"operation": {},
"rule_id": "string",
"search": {},
"severity": 0,
"state": "string",
"status": "string",
"status_msg": "string",
"tactic": "string",
"technique": "string",
"template_id": "string",
"type": "string",
"updated_by_api_client_id": "string",
"updated_by_user_id": "string",
"updated_by_user_uuid": "string",
"user_id": "string",
"user_uuid": "string",
"version": 0
}
]


Find all rule IDs matching the query and filter.

Method GET
Route /correlation-rules/queries/rules/v1
Scope Correlation Rules: READ
PEP 8 query_rules
filter query · string
FQL query specifying the filter parameters
Available values (9)
customer_iduser_iduser_uuid
statusnamecreated_on
last_updated_oncreated_onlast_updated_on
q query · string
Match query criteria, which includes all the filter string fields
sort query · string
Rule property to sort on.
Available values (4)
created_oncreated_on|desclast_updated_on
last_updated_on|desc
offset query · integer
Starting index of overall result set from which to return IDs
limit query · integer
Number of IDs to return
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.query_rules(filter="string",
q="string",
sort="string",
offset=integer,
limit=integer)
print(response)
[
"string"
]


Find all rule version IDs matching the query and filter.

Method GET
Route /correlation-rules/queries/rules/v2
Scope Correlation Rules: READ
PEP 8 query_rules_v2
filter query · string
FQL query specifying the filter parameters
Available values (9)
customer_iduser_iduser_uuid
statusnamecreated_on
last_updated_oncreated_onlast_updated_on
q query · string
Match query criteria, which includes all the filter string fields
sort query · string
Rule property to sort on.
Available values (4)
created_oncreated_on|desclast_updated_on
last_updated_on|desc
offset query · integer
Starting index of overall result set from which to return IDs
limit query · integer
Number of IDs to return
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.query_rules_v2(filter="string",
q="string",
sort="string",
offset=integer,
limit=integer)
print(response)
[
"string"
]


Search rule template IDs matching the filter.

Method GET
Route /correlation-rules/queries/templates/v1
Scope Correlation Rules: READ
PEP 8 search_rule_template_ids
filter query · string
FQL query specifying the filter parameters
Available values (9)
namedescriptionvendor
outcomemitre_attack.tactic_idmitre_attack.technique_id
typecreated_onlast_updated_on
sort query · string
Rule property to sort on.
Available values (4)
created_oncreated_on|desclast_updated_on
last_updated_on|desc
offset query · integer
Starting index of overall result set from which to return IDs
limit query · integer
Number of IDs to return
parameters query · dictionary
Full query string parameters payload in JSON format. Not required when using other keywords.
from falconpy import CorrelationRules
falcon = CorrelationRules(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.search_rule_template_ids(filter="string",
sort="string",
offset=integer,
limit=integer)
print(response)
[
"string"
]