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

lib/datadog_api_client/v2/models/batch_rows_query_request.rb

@@ -17,11 +17,11 @@
 require 'time'
 
 module DatadogAPIClient::V2
-  # 
+  # Request object for querying multiple rows from a reference table by their identifiers.
   class BatchRowsQueryRequest
     include BaseGenericModel
 
-    #
+    # Data object for a batch rows query request.
     attr_accessor :data
 
     attr_accessor :additional_properties

lib/datadog_api_client/v2/models/batch_rows_query_request_data.rb

@@ -17,11 +17,11 @@
 require 'time'
 
 module DatadogAPIClient::V2
-  # 
+  # Data object for a batch rows query request.
   class BatchRowsQueryRequestData
     include BaseGenericModel
 
-    #
+    # Attributes for a batch rows query request.
     attr_accessor :attributes
 
     # Resource type identifier for batch queries of reference table rows.

lib/datadog_api_client/v2/models/batch_rows_query_request_data_attributes.rb

@@ -17,14 +17,14 @@
 require 'time'
 
 module DatadogAPIClient::V2
-  # 
+  # Attributes for a batch rows query request.
   class BatchRowsQueryRequestDataAttributes
     include BaseGenericModel
 
-    #
+    # List of row identifiers to query from the reference table.
     attr_reader :row_ids
 
-    #
+    # Unique identifier of the reference table to query.
     attr_reader :table_id
 
     attr_accessor :additional_properties

lib/datadog_api_client/v2/models/batch_rows_query_response.rb

@@ -17,11 +17,11 @@
 require 'time'
 
 module DatadogAPIClient::V2
-  # 
+  # Response object for a batch rows query against a reference table.
   class BatchRowsQueryResponse
     include BaseGenericModel
 
-    #
+    # Data object for a batch rows query response.
     attr_accessor :data
 
     attr_accessor :additional_properties

lib/datadog_api_client/v2/models/batch_rows_query_response_data.rb

@@ -17,14 +17,14 @@
 require 'time'
 
 module DatadogAPIClient::V2
-  # 
+  # Data object for a batch rows query response.
   class BatchRowsQueryResponseData
     include BaseGenericModel
 
-    #
+    # Unique identifier of the batch query.
     attr_accessor :id
 
-    #
+    # Relationships of the batch rows query response data.
     attr_accessor :relationships
 
     # Resource type identifier for batch queries of reference table rows.

lib/datadog_api_client/v2/models/batch_rows_query_response_data_relationships.rb

@@ -17,11 +17,11 @@
 require 'time'
 
 module DatadogAPIClient::V2
-  # 
+  # Relationships of the batch rows query response data.
   class BatchRowsQueryResponseDataRelationships
     include BaseGenericModel
 
-    #
+    # Relationship data containing the list of matching rows.
     attr_accessor :rows
 
     attr_accessor :additional_properties

lib/datadog_api_client/v2/models/batch_rows_query_response_data_relationships_rows.rb

@@ -17,7 +17,7 @@
 require 'time'
 
 module DatadogAPIClient::V2
-  # 
+  # Relationship data containing the list of matching rows.
   class BatchRowsQueryResponseDataRelationshipsRows
     include BaseGenericModel
 

lib/datadog_api_client/v2/models/environments_pagination_meta.rb

@@ -21,7 +21,7 @@ module DatadogAPIClient::V2
   class EnvironmentsPaginationMeta
     include BaseGenericModel
 
-    #
+    # Pagination metadata for environments list responses.
     attr_accessor :page
 
     attr_accessor :additional_properties

lib/datadog_api_client/v2/models/environments_pagination_meta_page.rb

@@ -17,7 +17,7 @@
 require 'time'
 
 module DatadogAPIClient::V2
-  # 
+  # Pagination metadata for environments list responses.
   class EnvironmentsPaginationMetaPage
     include BaseGenericModel
 

lib/datadog_api_client/v2/models/feature_flags_pagination_meta.rb

@@ -21,7 +21,7 @@ module DatadogAPIClient::V2
   class FeatureFlagsPaginationMeta
     include BaseGenericModel
 
-    #
+    # Pagination metadata for feature flags list responses.
     attr_accessor :page
 
     attr_accessor :additional_properties

lib/datadog_api_client/v2/models/feature_flags_pagination_meta_page.rb

@@ -17,7 +17,7 @@
 require 'time'
 
 module DatadogAPIClient::V2
-  # 
+  # Pagination metadata for feature flags list responses.
   class FeatureFlagsPaginationMetaPage
     include BaseGenericModel