diff --git a/.generator/schemas/v1/openapi.yaml b/.generator/schemas/v1/openapi.yaml
index 2d398cc12e..7bb1ef98cf 100644
--- a/.generator/schemas/v1/openapi.yaml
+++ b/.generator/schemas/v1/openapi.yaml
@@ -37782,7 +37782,10 @@ paths:
       x-codegen-request-body-name: body
   /api/v1/query:
     get:
-      description: Query timeseries points.
+      description: |-
+        Query timeseries points. Datadog recommends using the v2
+        `/api/v2/query/timeseries` endpoint over this endpoint for
+        querying timeseries data.
       operationId: QueryMetrics
       parameters:
         - description: Start of the queried time period, seconds since the Unix epoch.
diff --git a/.generator/schemas/v2/openapi.yaml b/.generator/schemas/v2/openapi.yaml
index d8f50ea930..a8f738df55 100644
--- a/.generator/schemas/v2/openapi.yaml
+++ b/.generator/schemas/v2/openapi.yaml
@@ -175956,7 +175956,9 @@ paths:
     post:
       description: |-
         Query timeseries data across various data sources and
-        process the data by applying formulas and functions.
+        process the data by applying formulas and functions. Datadog recommends
+        using this endpoint over the v1 `/api/v1/query` endpoint for querying
+        timeseries data.
       operationId: QueryTimeseriesData
       requestBody:
         content:
diff --git a/src/datadog_api_client/v1/api/metrics_api.py b/src/datadog_api_client/v1/api/metrics_api.py
index f1d5dfcca9..ee2a61583a 100644
--- a/src/datadog_api_client/v1/api/metrics_api.py
+++ b/src/datadog_api_client/v1/api/metrics_api.py
@@ -314,7 +314,9 @@ def query_metrics(
     ) -> MetricsQueryResponse:
         """Query timeseries points.
 
-        Query timeseries points.
+        Query timeseries points. Datadog recommends using the v2
+        ``/api/v2/query/timeseries`` endpoint over this endpoint for
+        querying timeseries data.
 
         :param _from: Start of the queried time period, seconds since the Unix epoch.
         :type _from: int
diff --git a/src/datadog_api_client/v2/api/metrics_api.py b/src/datadog_api_client/v2/api/metrics_api.py
index 4f59123f0d..e03b1ac386 100644
--- a/src/datadog_api_client/v2/api/metrics_api.py
+++ b/src/datadog_api_client/v2/api/metrics_api.py
@@ -1661,7 +1661,9 @@ def query_timeseries_data(
         """Query timeseries data across multiple products.
 
         Query timeseries data across various data sources and
-        process the data by applying formulas and functions.
+        process the data by applying formulas and functions. Datadog recommends
+        using this endpoint over the v1 ``/api/v1/query`` endpoint for querying
+        timeseries data.
 
         :type body: TimeseriesFormulaQueryRequest
         :rtype: TimeseriesFormulaQueryResponse