Deprecate Detects service collection and all related endpoints. Closes #1378.

Author: jshcodes

src/falconpy/_endpoint/_detects.py

@@ -41,7 +41,8 @@
     "GetAggregateDetects",
     "POST",
     "/detects/aggregates/detects/GET/v1",
-    "Get detect aggregates as specified via json in request body.",
+    "Deprecated: This endpoint will be decommissioned on September 30, 2025. Please check the Notes section "
+    "below for migration guidance.",
     "detects",
     [
       {
@@ -56,7 +57,8 @@
     "UpdateDetectsByIdsV2",
     "PATCH",
     "/detects/entities/detects/v2",
-    "Modify the state, assignee, and visibility of detections",
+    "Deprecated: This endpoint will be decommissioned on September 30, 2025. Please check the Notes section "
+    "below for migration guidance.",
     "detects",
     [
       {
@@ -80,7 +82,8 @@
     "GetDetectSummaries",
     "POST",
     "/detects/entities/summaries/GET/v1",
-    "View information about detections",
+    "Deprecated: This endpoint will be decommissioned on September 30, 2025. Please check the Notes section "
+    "below for migration guidance.",
     "detects",
     [
       {
@@ -99,7 +102,8 @@
     "QueryDetects",
     "GET",
     "/detects/queries/detects/v1",
-    "Search for detection IDs that match a given query",
+    "Deprecated: This endpoint will be decommissioned on September 30, 2025. Please check the Notes section "
+    "below for migration guidance.",
     "detects",
     [
       {

src/falconpy/_endpoint/deprecated/_mapping.py

@@ -59,11 +59,16 @@
     "DiscoverCloudAzureDownloadCertificate": "AzureDownloadCertificate",
     "GetDiscoverCloudAzureTenantIDs": "",
     "GetDiscoverCloudGCPUserScripts": "",
-    "GetHorizonD4CScripts": ""
+    "GetHorizonD4CScripts": "",
+    "GetAggregateDetects": "",
+    "UpdateDetectsByIdsV2": "",
+    "GetDetectSummaries": "",
+    "QueryDetects": ""
 }
 
 _deprecated_cls_mapping = {
     "CloudConnectAWS": "CSPMRegistration",
     "D4CRegistration": "CSPMRegistration",
-    "Iocs": "IOC"
+    "Iocs": "IOC",
+    "Detects": "Alerts"
 }

src/falconpy/detects.py

@@ -42,6 +42,14 @@
 from ._result import Result
 from ._service_class import ServiceClass
 from ._endpoint._detects import _detects_endpoints as Endpoints
+#  _____                                     __            __
+# |     \.-----.-----.----.-----.----.---.-.|  |_.-----.--|  |
+# |  --  |  -__|  _  |   _|  -__|  __|  _  ||   _|  -__|  _  |
+# |_____/|_____|   __|__| |_____|____|___._||____|_____|_____|
+#              |__|
+#
+# This service collection is deprecated.
+# Developers should leverage operations from the Alerts service collection.
 
 
 class Detects(ServiceClass):