chore(spec): add missing descriptions [audience-management-backend]

src/datadog_api_client/v2/model/create_connection_request.py

@@ -32,9 +32,9 @@ def openapi_types(_):
 
     def __init__(self_, data: Union[CreateConnectionRequestData, UnsetType] = unset, **kwargs):
         """
+        Request body for creating a new data source connection for an entity.
 
-
-        :param data:
+        :param data: The data object containing the resource type and attributes for creating a new connection.
         :type data: CreateConnectionRequestData, optional
         """
         if data is not unset:

src/datadog_api_client/v2/model/create_connection_request_data.py

@@ -48,12 +48,12 @@ def __init__(
         **kwargs,
     ):
         """
+        The data object containing the resource type and attributes for creating a new connection.
 
-
-        :param attributes:
+        :param attributes: Attributes defining the data source connection, including join configuration and custom fields.
         :type attributes: CreateConnectionRequestDataAttributes, optional
 
-        :param id:
+        :param id: Unique identifier for the new connection resource.
         :type id: str, optional
 
         :param type: Connection id resource type.

src/datadog_api_client/v2/model/create_connection_request_data_attributes.py

@@ -52,21 +52,21 @@ def __init__(
         **kwargs,
     ):
         """
+        Attributes defining the data source connection, including join configuration and custom fields.
 
-
-        :param fields:
+        :param fields: List of custom attribute fields to import from the data source.
         :type fields: [CreateConnectionRequestDataAttributesFieldsItems], optional
 
-        :param join_attribute:
+        :param join_attribute: The attribute in the data source used to join records with the entity.
         :type join_attribute: str
 
-        :param join_type:
+        :param join_type: The type of join key used to link the data source to the entity (for example, email or user_id).
         :type join_type: str
 
-        :param metadata:
+        :param metadata: Additional key-value metadata associated with the connection.
         :type metadata: {str: (str,)}, optional
 
-        :param type:
+        :param type: The type of data source connection (for example, ref_table).
         :type type: str
         """
         if fields is not unset:

src/datadog_api_client/v2/model/create_connection_request_data_attributes_fields_items.py

@@ -45,24 +45,24 @@ def __init__(
         **kwargs,
     ):
         """
+        Definition of a custom attribute field to import from a data source connection.
 
-
-        :param description:
+        :param description: Human-readable explanation of what the field represents.
         :type description: str, optional
 
-        :param display_name:
+        :param display_name: The human-readable label for the field shown in the UI.
         :type display_name: str, optional
 
-        :param groups:
+        :param groups: List of group labels used to categorize the field.
         :type groups: [str], optional
 
-        :param id:
+        :param id: The unique identifier for the field within the connection.
         :type id: str
 
-        :param source_name:
+        :param source_name: The name of the column or attribute in the source data system that maps to this field.
         :type source_name: str
 
-        :param type:
+        :param type: The data type of the field (for example, string or number).
         :type type: str
         """
         if description is not unset:

src/datadog_api_client/v2/model/facet_info_request.py

@@ -32,9 +32,9 @@ def openapi_types(_):
 
     def __init__(self_, data: Union[FacetInfoRequestData, UnsetType] = unset, **kwargs):
         """
+        Request body for retrieving facet value information for a specified attribute with optional filtering.
 
-
-        :param data:
+        :param data: The data object containing the resource type and attributes for the facet info request.
         :type data: FacetInfoRequestData, optional
         """
         if data is not unset:

src/datadog_api_client/v2/model/facet_info_request_data.py

@@ -44,12 +44,12 @@ def __init__(
         **kwargs,
     ):
         """
+        The data object containing the resource type and attributes for the facet info request.
 
-
-        :param attributes:
+        :param attributes: Attributes for the facet info request, specifying which facet to query and optional filters to apply.
         :type attributes: FacetInfoRequestDataAttributes, optional
 
-        :param id:
+        :param id: Unique identifier for the facet info request resource.
         :type id: str, optional
 
         :param type: Users facet info request resource type.

src/datadog_api_client/v2/model/facet_info_request_data_attributes.py

@@ -55,18 +55,18 @@ def __init__(
         **kwargs,
     ):
         """
+        Attributes for the facet info request, specifying which facet to query and optional filters to apply.
 
-
-        :param facet_id:
+        :param facet_id: The identifier of the facet attribute to retrieve value information for.
         :type facet_id: str
 
-        :param limit:
+        :param limit: Maximum number of facet values to return in the response.
         :type limit: int
 
-        :param search:
+        :param search: Query-based search configuration for filtering the audience context when retrieving facet values.
         :type search: FacetInfoRequestDataAttributesSearch, optional
 
-        :param term_search:
+        :param term_search: Term-level search configuration for filtering facet values by an exact or partial term match.
         :type term_search: FacetInfoRequestDataAttributesTermSearch, optional
         """
         if search is not unset:

src/datadog_api_client/v2/model/facet_info_request_data_attributes_search.py

@@ -26,9 +26,9 @@ def openapi_types(_):
 
     def __init__(self_, query: Union[str, UnsetType] = unset, **kwargs):
         """
+        Query-based search configuration for filtering the audience context when retrieving facet values.
 
-
-        :param query:
+        :param query: The filter expression used to scope the audience from which facet values are retrieved.
         :type query: str, optional
         """
         if query is not unset:

src/datadog_api_client/v2/model/facet_info_request_data_attributes_term_search.py

@@ -26,9 +26,9 @@ def openapi_types(_):
 
     def __init__(self_, value: Union[str, UnsetType] = unset, **kwargs):
         """
+        Term-level search configuration for filtering facet values by an exact or partial term match.
 
-
-        :param value:
+        :param value: The term string to match against facet values.
         :type value: str, optional
         """
         if value is not unset:

src/datadog_api_client/v2/model/facet_info_response.py

@@ -32,9 +32,9 @@ def openapi_types(_):
 
     def __init__(self_, data: Union[FacetInfoResponseData, UnsetType] = unset, **kwargs):
         """
+        Response containing facet information for an attribute, including its distinct values and occurrence counts.
 
-
-        :param data:
+        :param data: The data object containing the resource type and attributes for the facet info response.
         :type data: FacetInfoResponseData, optional
         """
         if data is not unset:

src/datadog_api_client/v2/model/facet_info_response_data.py

@@ -44,12 +44,12 @@ def __init__(
         **kwargs,
     ):
         """
+        The data object containing the resource type and attributes for the facet info response.
 
-
-        :param attributes:
+        :param attributes: Attributes of the facet info response, containing the facet result data.
         :type attributes: FacetInfoResponseDataAttributes, optional
 
-        :param id:
+        :param id: Unique identifier for the facet info response resource.
         :type id: str, optional
 
         :param type: Users facet info resource type.

src/datadog_api_client/v2/model/facet_info_response_data_attributes.py

@@ -36,9 +36,9 @@ def openapi_types(_):
 
     def __init__(self_, result: Union[FacetInfoResponseDataAttributesResult, UnsetType] = unset, **kwargs):
         """
+        Attributes of the facet info response, containing the facet result data.
 
-
-        :param result:
+        :param result: The facet query result containing discrete value counts or a numeric range for the requested facet.
         :type result: FacetInfoResponseDataAttributesResult, optional
         """
         if result is not unset:

src/datadog_api_client/v2/model/facet_info_response_data_attributes_result.py

@@ -49,12 +49,12 @@ def __init__(
         **kwargs,
     ):
         """
+        The facet query result containing discrete value counts or a numeric range for the requested facet.
 
-
-        :param range:
+        :param range: The numeric range of a facet attribute, representing the minimum and maximum observed values.
         :type range: FacetInfoResponseDataAttributesResultRange, optional
 
-        :param values:
+        :param values: List of discrete facet values with their occurrence counts.
         :type values: [FacetInfoResponseDataAttributesResultValuesItems], optional
         """
         if range is not unset:

src/datadog_api_client/v2/model/facet_info_response_data_attributes_result_range.py

@@ -28,12 +28,12 @@ def openapi_types(_):
 
     def __init__(self_, max: Union[dict, UnsetType] = unset, min: Union[dict, UnsetType] = unset, **kwargs):
         """
+        The numeric range of a facet attribute, representing the minimum and maximum observed values.
 
-
-        :param max:
+        :param max: The maximum observed value for the numeric facet attribute.
         :type max: dict, optional
 
-        :param min:
+        :param min: The minimum observed value for the numeric facet attribute.
         :type min: dict, optional
         """
         if max is not unset:

src/datadog_api_client/v2/model/facet_info_response_data_attributes_result_values_items.py

@@ -28,12 +28,12 @@ def openapi_types(_):
 
     def __init__(self_, count: Union[int, UnsetType] = unset, value: Union[str, UnsetType] = unset, **kwargs):
         """
+        A single facet value with its occurrence count in the dataset.
 
-
-        :param count:
+        :param count: The number of records that have this facet value.
         :type count: int, optional
 
-        :param value:
+        :param value: The facet value (for example, a browser name or country code).
         :type value: str, optional
         """
         if count is not unset:

src/datadog_api_client/v2/model/get_mapping_response.py

@@ -32,9 +32,9 @@ def openapi_types(_):
 
     def __init__(self_, data: Union[GetMappingResponseData, UnsetType] = unset, **kwargs):
         """
+        Response containing the entity attribute mapping configuration including all available attributes and their properties.
 
-
-        :param data:
+        :param data: The data object containing the resource type and attributes for the get mapping response.
         :type data: GetMappingResponseData, optional
         """
         if data is not unset:

src/datadog_api_client/v2/model/get_mapping_response_data.py

@@ -44,12 +44,12 @@ def __init__(
         **kwargs,
     ):
         """
+        The data object containing the resource type and attributes for the get mapping response.
 
-
-        :param attributes:
+        :param attributes: Attributes of the get mapping response, containing the list of configured entity attributes.
         :type attributes: GetMappingResponseDataAttributes, optional
 
-        :param id:
+        :param id: Unique identifier for the get mapping response resource.
         :type id: str, optional
 
         :param type: Get mappings response resource type.

src/datadog_api_client/v2/model/get_mapping_response_data_attributes.py

@@ -38,9 +38,9 @@ def __init__(
         self_, attributes: Union[List[GetMappingResponseDataAttributesAttributesItems], UnsetType] = unset, **kwargs
     ):
         """
+        Attributes of the get mapping response, containing the list of configured entity attributes.
 
-
-        :param attributes:
+        :param attributes: The list of entity attributes and their mapping configurations.
         :type attributes: [GetMappingResponseDataAttributesAttributesItems], optional
         """
         if attributes is not unset: