Add missing descriptions to schemas, properties, and array items

.generator/schemas/v2/openapi.yaml

@@ -4307,6 +4307,7 @@ components:
         ip_list:
           description: The client IP addresses matched by the exclusion filter (CIDR notation is supported).
           items:
+            description: A single IP address to exclude.
             example: "198.51.100.72"
             type: string
           type: array
@@ -4317,6 +4318,7 @@ components:
         parameters:
           description: A list of parameters matched by the exclusion filter in the HTTP query string and HTTP request body. Nested parameters can be matched by joining fields with a dot character.
           items:
+            description: A request parameter name to exclude from the query string or request body.
             example: "list.search.query"
             type: string
           type: array
@@ -4353,6 +4355,7 @@ components:
         ip_list:
           description: The client IP addresses matched by the exclusion filter (CIDR notation is supported).
           items:
+            description: A single IP address to exclude.
             example: "198.51.100.72"
             type: string
           type: array
@@ -4361,6 +4364,7 @@ components:
         parameters:
           description: A list of parameters matched by the exclusion filter in the HTTP query string and HTTP request body. Nested parameters can be matched by joining fields with a dot character.
           items:
+            description: A request parameter name to exclude from the query string or request body.
             example: "list.search.query"
             type: string
           type: array
@@ -4512,6 +4516,7 @@ components:
         ip_list:
           description: The client IP addresses matched by the exclusion filter (CIDR notation is supported).
           items:
+            description: A single IP address to exclude.
             example: "198.51.100.72"
             type: string
           type: array
@@ -7348,11 +7353,13 @@ components:
       x-enum-varnames:
         - REFERENCE_TABLES_BATCH_ROWS_QUERY
     BatchRowsQueryRequest:
+      description: Request object for querying multiple rows from a reference table by their identifiers.
       properties:
         data:
           $ref: "#/components/schemas/BatchRowsQueryRequestData"
       type: object
     BatchRowsQueryRequestData:
+      description: Data object for a batch rows query request.
       properties:
         attributes:
           $ref: "#/components/schemas/BatchRowsQueryRequestDataAttributes"
@@ -7362,22 +7369,27 @@ components:
         - type
       type: object
     BatchRowsQueryRequestDataAttributes:
+      description: Attributes for a batch rows query request.
       properties:
         row_ids:
+          description: List of row identifiers to query from the reference table.
           example:
             - "row_id_1"
             - "row_id_2"
           items:
+            description: A single row identifier.
             type: string
           type: array
         table_id:
+          description: Unique identifier of the reference table to query.
           example: "00000000-0000-0000-0000-000000000000"
           type: string
       required:
         - row_ids
         - table_id
       type: object
     BatchRowsQueryResponse:
+      description: Response object for a batch rows query against a reference table.
       example:
         data:
           id: 00000000-0000-0000-0000-000000000000
@@ -7394,8 +7406,10 @@ components:
           $ref: "#/components/schemas/BatchRowsQueryResponseData"
       type: object
     BatchRowsQueryResponseData:
+      description: Data object for a batch rows query response.
       properties:
         id:
+          description: Unique identifier of the batch query.
           type: string
         relationships:
           $ref: "#/components/schemas/BatchRowsQueryResponseDataRelationships"
@@ -7405,11 +7419,13 @@ components:
         - type
       type: object
     BatchRowsQueryResponseDataRelationships:
+      description: Relationships of the batch rows query response data.
       properties:
         rows:
           $ref: "#/components/schemas/BatchRowsQueryResponseDataRelationshipsRows"
       type: object
     BatchRowsQueryResponseDataRelationshipsRows:
+      description: Relationship data containing the list of matching rows.
       properties:
         data:
           items:
@@ -14945,6 +14961,7 @@ components:
           description: List of queries to define the environment scope.
           example: ["staging", "test"]
           items:
+            description: A query string used to match the environment scope.
             type: string
           minItems: 1
           type: array
@@ -15340,6 +15357,7 @@ components:
         tags:
           description: User-defined tags for organizing the widget.
           items:
+            description: A single user-defined tag.
             type: string
           nullable: true
           type: array
@@ -15396,6 +15414,7 @@ components:
         tags:
           description: Tags to help categorize or filter the page.
           items:
+            description: A single tag for categorizing the page.
             type: string
           type: array
         target:
@@ -23215,6 +23234,7 @@ components:
           description: List of queries to define the environment scope.
           example: ["staging", "test"]
           items:
+            description: A query string used to match the environment scope.
             type: string
           minItems: 1
           type: array
@@ -23245,6 +23265,7 @@ components:
           $ref: "#/components/schemas/EnvironmentsPaginationMetaPage"
       type: object
     EnvironmentsPaginationMetaPage:
+      description: Pagination metadata for environments list responses.
       properties:
         total_count:
           description: Total number of items.
@@ -25194,6 +25215,7 @@ components:
           $ref: "#/components/schemas/FeatureFlagsPaginationMetaPage"
       type: object
     FeatureFlagsPaginationMetaPage:
+      description: Pagination metadata for feature flags list responses.
       properties:
         total_count:
           description: Total number of items.
@@ -41704,6 +41726,7 @@ components:
           description: A list of component IDs whose output is used as the `input` for this component.
           example: ["filter-processor"]
           items:
+            description: A component ID referenced as an input source.
             type: string
           type: array
         key_prefix:
@@ -45772,6 +45795,7 @@ components:
           description: List of log field names to send as indexed fields to Splunk HEC. Available only when `encoding` is `json`.
           example: ["service", "host"]
           items:
+            description: A log field name to index in Splunk.
             type: string
           type: array
         inputs:
@@ -48289,6 +48313,7 @@ components:
         name_aliases:
           description: List of alias names for the permission.
           items:
+            description: An alternative name for the permission.
             type: string
           type: array
         restricted:
@@ -69801,6 +69826,7 @@ components:
           description: List of queries to define the environment scope.
           example: ["staging", "test"]
           items:
+            description: A query string used to match the environment scope.
             type: string
           minItems: 1
           type: array
@@ -72285,6 +72311,7 @@ components:
           example:
             - "team:my-team"
           items:
+            description: A single user-defined tag.
             type: string
           nullable: true
           type: array

src/main/java/com/datadog/api/client/v2/model/BatchRowsQueryRequest.java

@@ -16,7 +16,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** */
+/** Request object for querying multiple rows from a reference table by their identifiers. */
 @JsonPropertyOrder({BatchRowsQueryRequest.JSON_PROPERTY_DATA})
 @jakarta.annotation.Generated(
     value = "https://github.com/DataDog/datadog-api-client-java/blob/master/.generator")
@@ -32,7 +32,7 @@ public BatchRowsQueryRequest data(BatchRowsQueryRequestData data) {
   }
 
   /**
-   * Getdata
+   * Data object for a batch rows query request.
    *
    * @return data
    */

src/main/java/com/datadog/api/client/v2/model/BatchRowsQueryRequestData.java

@@ -17,7 +17,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** */
+/** Data object for a batch rows query request. */
 @JsonPropertyOrder({
   BatchRowsQueryRequestData.JSON_PROPERTY_ATTRIBUTES,
   BatchRowsQueryRequestData.JSON_PROPERTY_TYPE
@@ -48,7 +48,7 @@ public BatchRowsQueryRequestData attributes(BatchRowsQueryRequestDataAttributes
   }
 
   /**
-   * Getattributes
+   * Attributes for a batch rows query request.
    *
    * @return attributes
    */

src/main/java/com/datadog/api/client/v2/model/BatchRowsQueryRequestDataAttributes.java

@@ -19,7 +19,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** */
+/** Attributes for a batch rows query request. */
 @JsonPropertyOrder({
   BatchRowsQueryRequestDataAttributes.JSON_PROPERTY_ROW_IDS,
   BatchRowsQueryRequestDataAttributes.JSON_PROPERTY_TABLE_ID
@@ -55,7 +55,7 @@ public BatchRowsQueryRequestDataAttributes addRowIdsItem(String rowIdsItem) {
   }
 
   /**
-   * GetrowIds
+   * List of row identifiers to query from the reference table.
    *
    * @return rowIds
    */
@@ -75,7 +75,7 @@ public BatchRowsQueryRequestDataAttributes tableId(String tableId) {
   }
 
   /**
-   * GettableId
+   * Unique identifier of the reference table to query.
    *
    * @return tableId
    */

src/main/java/com/datadog/api/client/v2/model/BatchRowsQueryResponse.java

@@ -16,7 +16,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** */
+/** Response object for a batch rows query against a reference table. */
 @JsonPropertyOrder({BatchRowsQueryResponse.JSON_PROPERTY_DATA})
 @jakarta.annotation.Generated(
     value = "https://github.com/DataDog/datadog-api-client-java/blob/master/.generator")
@@ -32,7 +32,7 @@ public BatchRowsQueryResponse data(BatchRowsQueryResponseData data) {
   }
 
   /**
-   * Getdata
+   * Data object for a batch rows query response.
    *
    * @return data
    */

src/main/java/com/datadog/api/client/v2/model/BatchRowsQueryResponseData.java

@@ -17,7 +17,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** */
+/** Data object for a batch rows query response. */
 @JsonPropertyOrder({
   BatchRowsQueryResponseData.JSON_PROPERTY_ID,
   BatchRowsQueryResponseData.JSON_PROPERTY_RELATIONSHIPS,
@@ -51,7 +51,7 @@ public BatchRowsQueryResponseData id(String id) {
   }
 
   /**
-   * Getid
+   * Unique identifier of the batch query.
    *
    * @return id
    */
@@ -74,7 +74,7 @@ public BatchRowsQueryResponseData relationships(
   }
 
   /**
-   * Getrelationships
+   * Relationships of the batch rows query response data.
    *
    * @return relationships
    */

src/main/java/com/datadog/api/client/v2/model/BatchRowsQueryResponseDataRelationships.java

@@ -16,7 +16,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** */
+/** Relationships of the batch rows query response data. */
 @JsonPropertyOrder({BatchRowsQueryResponseDataRelationships.JSON_PROPERTY_ROWS})
 @jakarta.annotation.Generated(
     value = "https://github.com/DataDog/datadog-api-client-java/blob/master/.generator")
@@ -33,7 +33,7 @@ public BatchRowsQueryResponseDataRelationships rows(
   }
 
   /**
-   * Getrows
+   * Relationship data containing the list of matching rows.
    *
    * @return rows
    */

src/main/java/com/datadog/api/client/v2/model/BatchRowsQueryResponseDataRelationshipsRows.java

@@ -18,7 +18,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** */
+/** Relationship data containing the list of matching rows. */
 @JsonPropertyOrder({BatchRowsQueryResponseDataRelationshipsRows.JSON_PROPERTY_DATA})
 @jakarta.annotation.Generated(
     value = "https://github.com/DataDog/datadog-api-client-java/blob/master/.generator")

src/main/java/com/datadog/api/client/v2/model/EnvironmentsPaginationMeta.java

@@ -32,7 +32,7 @@ public EnvironmentsPaginationMeta page(EnvironmentsPaginationMetaPage page) {
   }
 
   /**
-   * Getpage
+   * Pagination metadata for environments list responses.
    *
    * @return page
    */

src/main/java/com/datadog/api/client/v2/model/EnvironmentsPaginationMetaPage.java

@@ -16,7 +16,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** */
+/** Pagination metadata for environments list responses. */
 @JsonPropertyOrder({
   EnvironmentsPaginationMetaPage.JSON_PROPERTY_TOTAL_COUNT,
   EnvironmentsPaginationMetaPage.JSON_PROPERTY_TOTAL_FILTERED_COUNT

src/main/java/com/datadog/api/client/v2/model/FeatureFlagsPaginationMeta.java

@@ -32,7 +32,7 @@ public FeatureFlagsPaginationMeta page(FeatureFlagsPaginationMetaPage page) {
   }
 
   /**
-   * Getpage
+   * Pagination metadata for feature flags list responses.
    *
    * @return page
    */

src/main/java/com/datadog/api/client/v2/model/FeatureFlagsPaginationMetaPage.java

@@ -16,7 +16,7 @@
 import java.util.Map;
 import java.util.Objects;
 
-/** */
+/** Pagination metadata for feature flags list responses. */
 @JsonPropertyOrder({
   FeatureFlagsPaginationMetaPage.JSON_PROPERTY_TOTAL_COUNT,
   FeatureFlagsPaginationMetaPage.JSON_PROPERTY_TOTAL_FILTERED_COUNT