chore(spec): add missing descriptions to OpenAPI schemas and properties [all]

src/datadog_api_client/v2/api/case_management_api.py

@@ -1044,7 +1044,7 @@ def create_project(
 
         Create a project.
 
-        :param body: Project payload
+        :param body: Project payload.
         :type body: ProjectCreateRequest
         :rtype: ProjectResponse
         """
@@ -1127,7 +1127,7 @@ def delete_project(
 
         Remove a project using the project's ``id``.
 
-        :param project_id: Project UUID
+        :param project_id: Project UUID.
         :type project_id: str
         :rtype: None
         """
@@ -1183,7 +1183,7 @@ def get_project(
 
         Get the details of a project by ``project_id``.
 
-        :param project_id: Project UUID
+        :param project_id: Project UUID.
         :type project_id: str
         :rtype: ProjectResponse
         """
@@ -1570,9 +1570,9 @@ def update_project(
 
         Update a project.
 
-        :param project_id: Project UUID
+        :param project_id: Project UUID.
         :type project_id: str
-        :param body: Project payload
+        :param body: Project payload.
         :type body: ProjectUpdateRequest
         :rtype: ProjectResponse
         """

src/datadog_api_client/v2/model/any_value_item.py

@@ -12,7 +12,9 @@
 
 class AnyValueItem(ModelComposed):
     def __init__(self, **kwargs):
-        """ """
+        """
+        A single item in an array of arbitrary values, which can be a string, number, object, or boolean.
+        """
         super().__init__(kwargs)
 
     @cached_property

src/datadog_api_client/v2/model/any_value_object.py

@@ -11,5 +11,7 @@
 
 class AnyValueObject(ModelNormal):
     def __init__(self_, **kwargs):
-        """ """
+        """
+        An arbitrary object value with additional properties.
+        """
         super().__init__(kwargs)

src/datadog_api_client/v2/model/argument.py

@@ -25,7 +25,7 @@ def openapi_types(_):
 
     def __init__(self_, description: str, name: str, **kwargs):
         """
-
+        A named argument for a custom static analysis rule.
 
         :param description: Base64-encoded argument description
         :type description: str

src/datadog_api_client/v2/model/assign_seats_user_request.py

@@ -32,9 +32,9 @@ def openapi_types(_):
 
     def __init__(self_, data: Union[AssignSeatsUserRequestData, UnsetType] = unset, **kwargs):
         """
+        The request body for assigning seats to users for a product code.
 
-
-        :param data:
+        :param data: The request data object containing attributes for assigning seats to users.
         :type data: AssignSeatsUserRequestData, optional
         """
         if data is not unset:

src/datadog_api_client/v2/model/assign_seats_user_request_data.py

@@ -48,9 +48,9 @@ def __init__(
         **kwargs,
     ):
         """
+        The request data object containing attributes for assigning seats to users.
 
-
-        :param attributes:
+        :param attributes: Attributes specifying the product and users to whom seats will be assigned.
         :type attributes: AssignSeatsUserRequestDataAttributes
 
         :param id: The ID of the assign seats user request.

src/datadog_api_client/v2/model/assign_seats_user_request_data_attributes.py

@@ -26,7 +26,7 @@ def openapi_types(_):
 
     def __init__(self_, product_code: str, user_uuids: List[str], **kwargs):
         """
-
+        Attributes specifying the product and users to whom seats will be assigned.
 
         :param product_code: The product code for which to assign seats.
         :type product_code: str

src/datadog_api_client/v2/model/assign_seats_user_response.py

@@ -32,9 +32,9 @@ def openapi_types(_):
 
     def __init__(self_, data: Union[AssignSeatsUserResponseData, UnsetType] = unset, **kwargs):
         """
+        The response body returned after successfully assigning seats to users.
 
-
-        :param data:
+        :param data: The response data object containing attributes of the seat assignment result.
         :type data: AssignSeatsUserResponseData, optional
         """
         if data is not unset:

src/datadog_api_client/v2/model/assign_seats_user_response_data.py

@@ -48,9 +48,9 @@ def __init__(
         **kwargs,
     ):
         """
+        The response data object containing attributes of the seat assignment result.
 
-
-        :param attributes:
+        :param attributes: Attributes of the assign seats response, including the list of users assigned and the product code.
         :type attributes: AssignSeatsUserResponseDataAttributes, optional
 
         :param id: The ID of the assign seats user response.

src/datadog_api_client/v2/model/assign_seats_user_response_data_attributes.py

@@ -30,7 +30,7 @@ def __init__(
         self_, assigned_ids: Union[List[str], UnsetType] = unset, product_code: Union[str, UnsetType] = unset, **kwargs
     ):
         """
-
+        Attributes of the assign seats response, including the list of users assigned and the product code.
 
         :param assigned_ids: The list of user IDs to which the seats were assigned.
         :type assigned_ids: [str], optional

src/datadog_api_client/v2/model/attachment.py

@@ -47,7 +47,7 @@ def __init__(
         :param data: Attachment data from a response.
         :type data: AttachmentData, optional
 
-        :param included:
+        :param included: A list of related objects included in the response.
         :type included: [AttachmentIncluded], optional
         """
         if data is not unset:

src/datadog_api_client/v2/model/attachment_array.py

@@ -44,10 +44,10 @@ def __init__(
         """
         A list of incident attachments.
 
-        :param data:
+        :param data: An array of attachment data objects.
         :type data: [AttachmentData]
 
-        :param included:
+        :param included: A list of related objects included in the response.
         :type included: [AttachmentIncluded], optional
         """
         if included is not unset:

src/datadog_api_client/v2/model/auto_close_inactive_cases.py

@@ -33,12 +33,12 @@ def __init__(
         **kwargs,
     ):
         """
-        Auto-close inactive cases settings
+        Auto-close inactive cases settings.
 
-        :param enabled: Whether auto-close is enabled
+        :param enabled: Whether auto-close is enabled.
         :type enabled: bool, optional
 
-        :param max_inactive_time_in_secs: Maximum inactive time in seconds before auto-closing
+        :param max_inactive_time_in_secs: Maximum inactive time in seconds before auto-closing.
         :type max_inactive_time_in_secs: int, optional
         """
         if enabled is not unset:

src/datadog_api_client/v2/model/auto_transition_assigned_cases.py

@@ -26,9 +26,9 @@ def openapi_types(_):
 
     def __init__(self_, auto_transition_assigned_cases_on_self_assigned: Union[bool, UnsetType] = unset, **kwargs):
         """
-        Auto-transition assigned cases settings
+        Auto-transition assigned cases settings.
 
-        :param auto_transition_assigned_cases_on_self_assigned: Whether to auto-transition cases when self-assigned
+        :param auto_transition_assigned_cases_on_self_assigned: Whether to auto-transition cases when self-assigned.
         :type auto_transition_assigned_cases_on_self_assigned: bool, optional
         """
         if auto_transition_assigned_cases_on_self_assigned is not unset:

src/datadog_api_client/v2/model/batch_delete_rows_request_array.py

@@ -38,7 +38,7 @@ def __init__(self_, data: List[TableRowResourceIdentifier], **kwargs):
         """
         The request body for deleting multiple rows from a reference table.
 
-        :param data:
+        :param data: List of row resources to delete from the reference table.
         :type data: [TableRowResourceIdentifier]
         """
         super().__init__(kwargs)

src/datadog_api_client/v2/model/batch_upsert_rows_request_array.py

@@ -38,7 +38,7 @@ def __init__(self_, data: List[BatchUpsertRowsRequestData], **kwargs):
         """
         The request body for creating or updating multiple rows into a reference table.
 
-        :param data:
+        :param data: List of row resources to create or update in the reference table.
         :type data: [BatchUpsertRowsRequestData]
         """
         super().__init__(kwargs)

src/datadog_api_client/v2/model/batch_upsert_rows_request_data.py

@@ -53,7 +53,7 @@ def __init__(
         :param attributes: Attributes containing row data values for row creation or update operations.
         :type attributes: BatchUpsertRowsRequestDataAttributes, optional
 
-        :param id:
+        :param id: The primary key value that uniquely identifies the row to create or update.
         :type id: str
 
         :param type: Row resource type.

src/datadog_api_client/v2/model/budget_attributes.py

@@ -81,7 +81,7 @@ def __init__(
         :param end_month: The month when the budget ends.
         :type end_month: int, optional
 
-        :param entries:
+        :param entries: The list of monthly budget entries.
         :type entries: [BudgetWithEntriesDataAttributesEntriesItems], optional
 
         :param metrics_query: The cost query used to track against the budget.

src/datadog_api_client/v2/model/budget_validation_request.py

@@ -32,9 +32,9 @@ def openapi_types(_):
 
     def __init__(self_, data: Union[BudgetValidationRequestData, UnsetType] = unset, **kwargs):
         """
+        The request object for validating a budget configuration before creating or updating it.
 
-
-        :param data:
+        :param data: The data object for a budget validation request, containing the resource type, ID, and budget attributes to validate.
         :type data: BudgetValidationRequestData, optional
         """
         if data is not unset:

src/datadog_api_client/v2/model/budget_validation_request_data.py

@@ -44,12 +44,12 @@ def __init__(
         **kwargs,
     ):
         """
+        The data object for a budget validation request, containing the resource type, ID, and budget attributes to validate.
 
-
-        :param attributes:
+        :param attributes: The attributes of a budget including all its monthly entries.
         :type attributes: BudgetWithEntriesDataAttributes, optional
 
-        :param id:
+        :param id: The unique identifier of the budget to validate.
         :type id: str, optional
 
         :param type: Budget resource type.

src/datadog_api_client/v2/model/budget_validation_response.py

@@ -32,9 +32,9 @@ def openapi_types(_):
 
     def __init__(self_, data: Union[BudgetValidationResponseData, UnsetType] = unset, **kwargs):
         """
+        The response object for a budget validation request, containing the validation result data.
 
-
-        :param data:
+        :param data: The data object for a budget validation response, containing the resource type, ID, and validation attributes.
         :type data: BudgetValidationResponseData, optional
         """
         if data is not unset:

src/datadog_api_client/v2/model/budget_validation_response_data.py

@@ -48,12 +48,12 @@ def __init__(
         **kwargs,
     ):
         """
+        The data object for a budget validation response, containing the resource type, ID, and validation attributes.
 
-
-        :param attributes:
+        :param attributes: The attributes of a budget validation response, including any validation errors and the validity status.
         :type attributes: BudgetValidationResponseDataAttributes, optional
 
-        :param id:
+        :param id: The unique identifier of the budget being validated.
         :type id: str, optional
 
         :param type: Budget validation resource type.

src/datadog_api_client/v2/model/budget_validation_response_data_attributes.py

@@ -28,12 +28,12 @@ def openapi_types(_):
 
     def __init__(self_, errors: Union[List[str], UnsetType] = unset, valid: Union[bool, UnsetType] = unset, **kwargs):
         """
+        The attributes of a budget validation response, including any validation errors and the validity status.
 
-
-        :param errors:
+        :param errors: A list of validation error messages for the budget.
         :type errors: [str], optional
 
-        :param valid:
+        :param valid: Whether the budget configuration is valid.
         :type valid: bool, optional
         """
         if errors is not unset:

src/datadog_api_client/v2/model/budget_with_entries_data_attributes.py

@@ -70,39 +70,39 @@ def __init__(
         **kwargs,
     ):
         """
+        The attributes of a budget including all its monthly entries.
 
-
-        :param created_at:
+        :param created_at: The timestamp when the budget was created.
         :type created_at: int, optional
 
-        :param created_by:
+        :param created_by: The ID of the user that created the budget.
         :type created_by: str, optional
 
-        :param end_month:
+        :param end_month: The month when the budget ends, in YYYYMM format.
         :type end_month: int, optional
 
-        :param entries:
+        :param entries: The list of monthly budget entries.
         :type entries: [BudgetWithEntriesDataAttributesEntriesItems], optional
 
-        :param metrics_query:
+        :param metrics_query: The cost query used to track spending against the budget.
         :type metrics_query: str, optional
 
-        :param name:
+        :param name: The name of the budget.
         :type name: str, optional
 
-        :param org_id:
+        :param org_id: The ID of the organization the budget belongs to.
         :type org_id: int, optional
 
-        :param start_month:
+        :param start_month: The month when the budget starts, in YYYYMM format.
         :type start_month: int, optional
 
-        :param total_amount:
+        :param total_amount: The total budget amount across all entries.
         :type total_amount: float, optional
 
-        :param updated_at:
+        :param updated_at: The timestamp when the budget was last updated.
         :type updated_at: int, optional
 
-        :param updated_by:
+        :param updated_by: The ID of the user that last updated the budget.
         :type updated_by: str, optional
         """
         if created_at is not unset:

src/datadog_api_client/v2/model/budget_with_entries_data_attributes_entries_items.py

@@ -46,15 +46,15 @@ def __init__(
         **kwargs,
     ):
         """
+        A single monthly budget entry defining the allocated amount and optional tag filters for a specific month.
 
-
-        :param amount:
+        :param amount: The budgeted amount for this entry.
         :type amount: float, optional
 
-        :param month:
+        :param month: The month this budget entry applies to, in YYYYMM format.
         :type month: int, optional
 
-        :param tag_filters:
+        :param tag_filters: The list of tag filters that scope this budget entry to specific resources.
         :type tag_filters: [BudgetWithEntriesDataAttributesEntriesItemsTagFiltersItems], optional
         """
         if amount is not unset:

src/datadog_api_client/v2/model/budget_with_entries_data_attributes_entries_items_tag_filters_items.py

@@ -28,12 +28,12 @@ def openapi_types(_):
 
     def __init__(self_, tag_key: Union[str, UnsetType] = unset, tag_value: Union[str, UnsetType] = unset, **kwargs):
         """
+        A tag filter used to scope a budget entry to specific resource tags.
 
-
-        :param tag_key:
+        :param tag_key: The tag key to filter on.
         :type tag_key: str, optional
 
-        :param tag_value:
+        :param tag_value: The tag value to filter on.
         :type tag_value: str, optional
         """
         if tag_key is not unset:

src/datadog_api_client/v2/model/case_create_relationships.py

@@ -47,7 +47,7 @@ def __init__(
         :param assignee: Relationship to user.
         :type assignee: NullableUserRelationship, none_type, optional
 
-        :param project: Relationship to project
+        :param project: Relationship to project.
         :type project: ProjectRelationship
         """
         if assignee is not unset:

src/datadog_api_client/v2/model/case_management_project.py

@@ -32,7 +32,7 @@ def __init__(self_, data: CaseManagementProjectData, **kwargs):
         """
         Case management project.
 
-        :param data:
+        :param data: Data object representing a case management project.
         :type data: CaseManagementProjectData
         """
         super().__init__(kwargs)