Publish Product Analytics journey, retention, and Sankey queries to public docs

.generator/schemas/v2/openapi.yaml

@@ -82474,7 +82474,10 @@ components:
             $ref: "#/components/schemas/ProductAnalyticsGroupBy"
           type: array
         indexes:
-          description: Restrict the query to specific indexes. Max 1 entry.
+          deprecated: true
+          description: |-
+            Deprecated. Index selection is a rollout detail and will be removed.
+            Do not set this field.
           items:
             description: Index name to restrict the query to.
             type: string
@@ -82512,6 +82515,10 @@ components:
       properties:
         enforced_execution_type:
           $ref: "#/components/schemas/ProductAnalyticsExecutionType"
+          deprecated: true
+          description: |-
+            Deprecated. Selects the internal query execution infrastructure and will be removed.
+            Do not set this field.
         from:
           description: Start time in epoch milliseconds. Must be less than `to`.
           example: 1771232048460
@@ -82520,7 +82527,7 @@ components:
         query:
           $ref: "#/components/schemas/ProductAnalyticsAnalyticsQuery"
         request_id:
-          description: Optional request ID for multi-step query continuation.
+          description: Unique identifier of the query.
           type: string
         to:
           description: End time in epoch milliseconds.
@@ -82633,7 +82640,9 @@ components:
           example: count
           type: string
         interval:
-          description: Time bucket size in milliseconds. Required for timeseries queries.
+          description: |-
+            Time bucket size in milliseconds. Required for timeseries queries; ignored by the
+            scalar endpoint, which returns a single value.
           example: 3600000
           format: int64
           type: integer
@@ -82796,7 +82805,7 @@ components:
       description: Metadata for a Product Analytics query response.
       properties:
         request_id:
-          description: Unique identifier for the request, used for multi-step query continuation.
+          description: Unique identifier of the query.
           type: string
         status:
           $ref: "#/components/schemas/ProductAnalyticsResponseMetaStatus"
@@ -83016,7 +83025,9 @@ components:
           $ref: "#/components/schemas/ProductAnalyticsResponseMeta"
       type: object
     ProductAnalyticsTimeseriesResponseAttributes:
-      description: Attributes of a timeseries analytics response, containing series data, timestamps, and interval definitions.
+      description: |-
+        Attributes of a timeseries analytics response, containing series data, timestamps, and
+        interval definitions.
       properties:
         intervals:
           description: Interval definitions describing the time buckets used in the response.

src/datadog_api_client/v2/model/product_analytics_analytics_query.py

@@ -73,7 +73,8 @@ def __init__(
         :param group_by: Group-by rules for segmenting results.
         :type group_by: [ProductAnalyticsGroupBy], optional
 
-        :param indexes: Restrict the query to specific indexes. Max 1 entry.
+        :param indexes: Deprecated. Index selection is a rollout detail and will be removed.
+            Do not set this field. **Deprecated**.
         :type indexes: [str], optional
 
         :param query: A query definition discriminated by the ``data_source`` field.

src/datadog_api_client/v2/model/product_analytics_analytics_request_attributes.py

@@ -61,7 +61,7 @@ def __init__(
         :param query: The analytics query definition containing a base query, compute rule, and optional grouping.
         :type query: ProductAnalyticsAnalyticsQuery
 
-        :param request_id: Optional request ID for multi-step query continuation.
+        :param request_id: Unique identifier of the query.
         :type request_id: str, optional
 
         :param to: End time in epoch milliseconds.

src/datadog_api_client/v2/model/product_analytics_compute.py

@@ -41,7 +41,8 @@ def __init__(
         :param aggregation: The aggregation function (count, cardinality, avg, sum, min, max, etc.).
         :type aggregation: str
 
-        :param interval: Time bucket size in milliseconds. Required for timeseries queries.
+        :param interval: Time bucket size in milliseconds. Required for timeseries queries; ignored by the
+            scalar endpoint, which returns a single value.
         :type interval: int, optional
 
         :param metric: The metric to aggregate on. Required for non-count aggregations.

src/datadog_api_client/v2/model/product_analytics_response_meta.py

@@ -43,7 +43,7 @@ def __init__(
         """
         Metadata for a Product Analytics query response.
 
-        :param request_id: Unique identifier for the request, used for multi-step query continuation.
+        :param request_id: Unique identifier of the query.
         :type request_id: str, optional
 
         :param status: The execution status of a Product Analytics query.

src/datadog_api_client/v2/model/product_analytics_timeseries_response_attributes.py

@@ -48,7 +48,8 @@ def __init__(
         **kwargs,
     ):
         """
-        Attributes of a timeseries analytics response, containing series data, timestamps, and interval definitions.
+        Attributes of a timeseries analytics response, containing series data, timestamps, and
+        interval definitions.
 
         :param intervals: Interval definitions describing the time buckets used in the response.
         :type intervals: [ProductAnalyticsInterval], optional

src/datadog_api_client/v2/model/product_analytics_timeseries_response_data.py

@@ -54,7 +54,8 @@ def __init__(
         """
         Data object for a timeseries analytics response.
 
-        :param attributes: Attributes of a timeseries analytics response, containing series data, timestamps, and interval definitions.
+        :param attributes: Attributes of a timeseries analytics response, containing series data, timestamps, and
+            interval definitions.
         :type attributes: ProductAnalyticsTimeseriesResponseAttributes, optional
 
         :param id: Unique identifier for this response data object.