diff --git a/.generator/schemas/v1/openapi.yaml b/.generator/schemas/v1/openapi.yaml
index 2d398cc12e49..7bb1ef98cf2a 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 d8f50ea93052..a8f738df556d 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/packages/datadog-api-client-v1/apis/MetricsApi.ts b/packages/datadog-api-client-v1/apis/MetricsApi.ts
index c49396a29421..4118a65b056d 100644
--- a/packages/datadog-api-client-v1/apis/MetricsApi.ts
+++ b/packages/datadog-api-client-v1/apis/MetricsApi.ts
@@ -986,7 +986,9 @@ export class MetricsApi {
   }
 
   /**
-   * Query timeseries points.
+   * Query timeseries points. Datadog recommends using the v2
+   * `/api/v2/query/timeseries` endpoint over this endpoint for
+   * querying timeseries data.
    * @param param The request object
    */
   public queryMetrics(
diff --git a/packages/datadog-api-client-v2/apis/MetricsApi.ts b/packages/datadog-api-client-v2/apis/MetricsApi.ts
index 72cfc776be26..305372b18515 100644
--- a/packages/datadog-api-client-v2/apis/MetricsApi.ts
+++ b/packages/datadog-api-client-v2/apis/MetricsApi.ts
@@ -4497,7 +4497,9 @@ export class MetricsApi {
 
   /**
    * 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.
    * @param param The request object
    */
   public queryTimeseriesData(