Document missing response fields for the v1 Query timeseries points endpoint

.generator/schemas/v1/openapi.yaml

@@ -8919,6 +8919,11 @@ components:
           nullable: true
           readOnly: true
           type: string
+        attributes:
+          additionalProperties: {}
+          description: Additional read-only attributes returned for the series.
+          readOnly: true
+          type: object
         display_name:
           description: Display name of the metric.
           example: system.cpu.idle
@@ -9024,6 +9029,12 @@ components:
           example: time_series
           readOnly: true
           type: string
+        resp_version:
+          description: Version of the response format.
+          example: 1
+          format: int64
+          readOnly: true
+          type: integer
         series:
           description: List of timeseries queried.
           items:
@@ -9035,40 +9046,62 @@ components:
           example: ok
           readOnly: true
           type: string
+        times:
+          description: |-
+            Legacy field, always returned as an empty list. Timestamps are returned
+            in the `pointlist` of each entry of `series`.
+          items:
+            description: An unused legacy timestamp.
+          readOnly: true
+          type: array
         to_date:
           description: End of requested time window, milliseconds since Unix epoch.
           format: int64
           readOnly: true
           type: integer
+        values:
+          description: |-
+            Legacy field, always returned as an empty list. Timeseries values are
+            returned in the `pointlist` of each entry of `series`.
+          items:
+            description: An unused legacy value.
+          readOnly: true
+          type: array
       type: object
     MetricsQueryUnit:
       description: Object containing the metric unit family, scale factor, name, and short name.
       nullable: true
       properties:
         family:
           description: Unit family, allows for conversion between units of the same family, for scaling.
-          example: time
+          example: percentage
           readOnly: true
           type: string
+        id:
+          description: Unit identifier.
+          example: 17
+          format: int64
+          readOnly: true
+          type: integer
         name:
           description: Unit name
-          example: minute
+          example: percent
           readOnly: true
           type: string
         plural:
           description: Plural form of the unit name.
-          example: minutes
+          example: percent
           readOnly: true
           type: string
         scale_factor:
           description: Factor for scaling between units of the same family.
-          example: 60.0
+          example: 1.0
           format: double
           readOnly: true
           type: number
         short_name:
           description: Abbreviation of the unit.
-          example: min
+          example: "%"
           readOnly: true
           type: string
       type: object

features/v1/metrics.feature

@@ -93,6 +93,7 @@ Feature: Metrics
     When the request is sent
     Then the response status is 200 OK
     And the response "status" is equal to "ok"
+    And the response "resp_version" is equal to 1
     And the response "query" is equal to "system.cpu.idle{*}"
 
   @generated @skip @team:ddoghq/metrics-experience @team:ddoghq/metrics-index @team:ddoghq/metrics-intake @team:ddoghq/timeseries-query

packages/datadog-api-client-v1/models/MetricsQueryMetadata.ts

@@ -15,6 +15,10 @@ export class MetricsQueryMetadata {
    * Aggregation type.
    */
   "aggr"?: string;
+  /**
+   * Additional read-only attributes returned for the series.
+   */
+  "attributes"?: { [key: string]: any };
   /**
    * Display name of the metric.
    */
@@ -87,6 +91,10 @@ export class MetricsQueryMetadata {
       baseName: "aggr",
       type: "string",
     },
+    attributes: {
+      baseName: "attributes",
+      type: "{ [key: string]: any; }",
+    },
     displayName: {
       baseName: "display_name",
       type: "string",

packages/datadog-api-client-v1/models/MetricsQueryResponse.ts

@@ -35,6 +35,10 @@ export class MetricsQueryResponse {
    * Type of response.
    */
   "resType"?: string;
+  /**
+   * Version of the response format.
+   */
+  "respVersion"?: number;
   /**
    * List of timeseries queried.
    */
@@ -43,10 +47,20 @@ export class MetricsQueryResponse {
    * Status of the query.
    */
   "status"?: string;
+  /**
+   * Legacy field, always returned as an empty list. Timestamps are returned
+   * in the `pointlist` of each entry of `series`.
+   */
+  "times"?: Array<any>;
   /**
    * End of requested time window, milliseconds since Unix epoch.
    */
   "toDate"?: number;
+  /**
+   * Legacy field, always returned as an empty list. Timeseries values are
+   * returned in the `pointlist` of each entry of `series`.
+   */
+  "values"?: Array<any>;
 
   /**
    * A container for additional, undeclared properties.
@@ -89,6 +103,11 @@ export class MetricsQueryResponse {
       baseName: "res_type",
       type: "string",
     },
+    respVersion: {
+      baseName: "resp_version",
+      type: "number",
+      format: "int64",
+    },
     series: {
       baseName: "series",
       type: "Array<MetricsQueryMetadata>",
@@ -97,11 +116,19 @@ export class MetricsQueryResponse {
       baseName: "status",
       type: "string",
     },
+    times: {
+      baseName: "times",
+      type: "Array<any>",
+    },
     toDate: {
       baseName: "to_date",
       type: "number",
       format: "int64",
     },
+    values: {
+      baseName: "values",
+      type: "Array<any>",
+    },
     additionalProperties: {
       baseName: "additionalProperties",
       type: "{ [key: string]: any; }",

packages/datadog-api-client-v1/models/MetricsQueryUnit.ts

@@ -14,6 +14,10 @@ export class MetricsQueryUnit {
    * Unit family, allows for conversion between units of the same family, for scaling.
    */
   "family"?: string;
+  /**
+   * Unit identifier.
+   */
+  "id"?: number;
   /**
    * Unit name
    */
@@ -51,6 +55,11 @@ export class MetricsQueryUnit {
       baseName: "family",
       type: "string",
     },
+    id: {
+      baseName: "id",
+      type: "number",
+      format: "int64",
+    },
     name: {
       baseName: "name",
       type: "string",