Regenerate client from commit 7923551 of spec repo (#3160)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v2/openapi.yaml

@@ -24023,6 +24023,22 @@ components:
           type: string
         flaky_state:
           $ref: '#/components/schemas/FlakyTestAttributesFlakyState'
+        history:
+          description: 'Chronological history of status changes for this flaky test,
+            ordered from most recent to oldest.
+
+            Includes state transitions like new -> quarantined -> fixed, along with
+            the associated commit SHA when available.'
+          example:
+          - commit_sha: abc123def456
+            status: quarantined
+            timestamp: 1704067200000
+          - commit_sha: ''
+            status: new
+            timestamp: 1703980800000
+          items:
+            $ref: '#/components/schemas/FlakyTestHistory'
+          type: array
         last_flaked_branch:
           description: The branch name where the test exhibited flakiness for the
             last time.
@@ -24107,6 +24123,29 @@ components:
       - FIXED
       - QUARANTINED
       - DISABLED
+    FlakyTestHistory:
+      description: A single history entry representing a status change for a flaky
+        test.
+      properties:
+        commit_sha:
+          description: The commit SHA associated with this status change. Will be
+            an empty string if the commit SHA is not available.
+          example: abc123def456
+          type: string
+        status:
+          description: The test status at this point in history.
+          example: quarantined
+          type: string
+        timestamp:
+          description: Unix timestamp in milliseconds when this status change occurred.
+          example: 1704067200000
+          format: int64
+          type: integer
+      required:
+      - status
+      - commit_sha
+      - timestamp
+      type: object
     FlakyTestPipelineStats:
       description: CI pipeline related statistics for the flaky test. This information
         is only available if test runs are associated with CI pipeline events from
@@ -24253,6 +24292,17 @@ components:
       properties:
         filter:
           $ref: '#/components/schemas/FlakyTestsSearchFilter'
+        include_history:
+          default: false
+          description: 'Whether to include the status change history for each flaky
+            test in the response.
+
+            When set to true, each test will include a `history` array with chronological
+            status changes.
+
+            Defaults to false.'
+          example: true
+          type: boolean
         page:
           $ref: '#/components/schemas/FlakyTestsSearchPageOptions'
         sort:
@@ -101085,8 +101135,33 @@ paths:
 
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
     post:
-      description: List endpoint returning flaky tests from Flaky Test Management.
+      description: 'List endpoint returning flaky tests from Flaky Test Management.
         Results are paginated.
+
+
+        The response includes comprehensive test information including:
+
+        - Test identification and metadata (module, suite, name)
+
+        - Flaky state and categorization
+
+        - First and last flake occurrences (timestamp, branch, commit SHA)
+
+        - Test execution statistics from the last 7 days (failure rate)
+
+        - Pipeline impact metrics (failed pipelines count, total lost time)
+
+        - Complete status change history (optional, ordered from most recent to oldest)
+
+
+        Set `include_history` to `true` in the request to receive the status change
+        history for each test.
+
+        History is disabled by default for better performance.
+
+
+        Results support filtering by various facets including service, environment,
+        repository, branch, and test state.'
       operationId: SearchFlakyTests
       requestBody:
         content:

docs/datadog_api_client.v2.model.rst

@@ -10049,6 +10049,13 @@ datadog\_api\_client.v2.model.flaky\_test\_attributes\_flaky\_state module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.flaky\_test\_history module
+---------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.flaky_test_history
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.flaky\_test\_pipeline\_stats module
 -----------------------------------------------------------------
 

examples/v2/test-optimization/SearchFlakyTests.py

@@ -18,6 +18,7 @@
             filter=FlakyTestsSearchFilter(
                 query='flaky_test_state:active @git.repository.id_v2:"github.com/datadog/shopist"',
             ),
+            include_history=True,
             page=FlakyTestsSearchPageOptions(
                 cursor="eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==",
                 limit=25,

examples/v2/test-optimization/SearchFlakyTests_1224086727.py

@@ -18,6 +18,7 @@
             filter=FlakyTestsSearchFilter(
                 query='flaky_test_state:active @git.repository.id_v2:"github.com/datadog/shopist"',
             ),
+            include_history=True,
             page=FlakyTestsSearchPageOptions(
                 cursor="eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==",
                 limit=25,

examples/v2/test-optimization/SearchFlakyTests_209064879.py

@@ -0,0 +1,37 @@
+"""
+Search flaky tests returns "OK" response with history
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.test_optimization_api import TestOptimizationApi
+from datadog_api_client.v2.model.flaky_tests_search_filter import FlakyTestsSearchFilter
+from datadog_api_client.v2.model.flaky_tests_search_page_options import FlakyTestsSearchPageOptions
+from datadog_api_client.v2.model.flaky_tests_search_request import FlakyTestsSearchRequest
+from datadog_api_client.v2.model.flaky_tests_search_request_attributes import FlakyTestsSearchRequestAttributes
+from datadog_api_client.v2.model.flaky_tests_search_request_data import FlakyTestsSearchRequestData
+from datadog_api_client.v2.model.flaky_tests_search_request_data_type import FlakyTestsSearchRequestDataType
+from datadog_api_client.v2.model.flaky_tests_search_sort import FlakyTestsSearchSort
+
+body = FlakyTestsSearchRequest(
+    data=FlakyTestsSearchRequestData(
+        attributes=FlakyTestsSearchRequestAttributes(
+            filter=FlakyTestsSearchFilter(
+                query='flaky_test_state:active @git.repository.id_v2:"github.com/datadog/shopist"',
+            ),
+            page=FlakyTestsSearchPageOptions(
+                limit=10,
+            ),
+            sort=FlakyTestsSearchSort.FQN_ASCENDING,
+            include_history=True,
+        ),
+        type=FlakyTestsSearchRequestDataType.SEARCH_FLAKY_TESTS_REQUEST,
+    ),
+)
+
+configuration = Configuration()
+configuration.unstable_operations["search_flaky_tests"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = TestOptimizationApi(api_client)
+    response = api_instance.search_flaky_tests(body=body)
+
+    print(response)

src/datadog_api_client/v2/api/test_optimization_api.py

@@ -79,6 +79,20 @@ def search_flaky_tests(
 
         List endpoint returning flaky tests from Flaky Test Management. Results are paginated.
 
+        The response includes comprehensive test information including:
+
+        * Test identification and metadata (module, suite, name)
+        * Flaky state and categorization
+        * First and last flake occurrences (timestamp, branch, commit SHA)
+        * Test execution statistics from the last 7 days (failure rate)
+        * Pipeline impact metrics (failed pipelines count, total lost time)
+        * Complete status change history (optional, ordered from most recent to oldest)
+
+        Set ``include_history`` to ``true`` in the request to receive the status change history for each test.
+        History is disabled by default for better performance.
+
+        Results support filtering by various facets including service, environment, repository, branch, and test state.
+
         :type body: FlakyTestsSearchRequest, optional
         :rtype: FlakyTestsSearchResponse
         """

src/datadog_api_client/v2/model/flaky_test_attributes.py

@@ -16,6 +16,7 @@
 
 if TYPE_CHECKING:
     from datadog_api_client.v2.model.flaky_test_attributes_flaky_state import FlakyTestAttributesFlakyState
+    from datadog_api_client.v2.model.flaky_test_history import FlakyTestHistory
     from datadog_api_client.v2.model.flaky_test_pipeline_stats import FlakyTestPipelineStats
     from datadog_api_client.v2.model.flaky_test_run_metadata import FlakyTestRunMetadata
     from datadog_api_client.v2.model.flaky_test_stats import FlakyTestStats
@@ -25,6 +26,7 @@ class FlakyTestAttributes(ModelNormal):
     @cached_property
     def openapi_types(_):
         from datadog_api_client.v2.model.flaky_test_attributes_flaky_state import FlakyTestAttributesFlakyState
+        from datadog_api_client.v2.model.flaky_test_history import FlakyTestHistory
         from datadog_api_client.v2.model.flaky_test_pipeline_stats import FlakyTestPipelineStats
         from datadog_api_client.v2.model.flaky_test_run_metadata import FlakyTestRunMetadata
         from datadog_api_client.v2.model.flaky_test_stats import FlakyTestStats
@@ -38,6 +40,7 @@ def openapi_types(_):
             "first_flaked_ts": (int,),
             "flaky_category": (str, none_type),
             "flaky_state": (FlakyTestAttributesFlakyState,),
+            "history": ([FlakyTestHistory],),
             "last_flaked_branch": (str,),
             "last_flaked_sha": (str,),
             "last_flaked_ts": (int,),
@@ -59,6 +62,7 @@ def openapi_types(_):
         "first_flaked_ts": "first_flaked_ts",
         "flaky_category": "flaky_category",
         "flaky_state": "flaky_state",
+        "history": "history",
         "last_flaked_branch": "last_flaked_branch",
         "last_flaked_sha": "last_flaked_sha",
         "last_flaked_ts": "last_flaked_ts",
@@ -81,6 +85,7 @@ def __init__(
         first_flaked_ts: Union[int, UnsetType] = unset,
         flaky_category: Union[str, none_type, UnsetType] = unset,
         flaky_state: Union[FlakyTestAttributesFlakyState, UnsetType] = unset,
+        history: Union[List[FlakyTestHistory], UnsetType] = unset,
         last_flaked_branch: Union[str, UnsetType] = unset,
         last_flaked_sha: Union[str, UnsetType] = unset,
         last_flaked_ts: Union[int, UnsetType] = unset,
@@ -123,6 +128,10 @@ def __init__(
         :param flaky_state: The current state of the flaky test.
         :type flaky_state: FlakyTestAttributesFlakyState, optional
 
+        :param history: Chronological history of status changes for this flaky test, ordered from most recent to oldest.
+            Includes state transitions like new -> quarantined -> fixed, along with the associated commit SHA when available.
+        :type history: [FlakyTestHistory], optional
+
         :param last_flaked_branch: The branch name where the test exhibited flakiness for the last time.
         :type last_flaked_branch: str, optional
 
@@ -178,6 +187,8 @@ def __init__(
             kwargs["flaky_category"] = flaky_category
         if flaky_state is not unset:
             kwargs["flaky_state"] = flaky_state
+        if history is not unset:
+            kwargs["history"] = history
         if last_flaked_branch is not unset:
             kwargs["last_flaked_branch"] = last_flaked_branch
         if last_flaked_sha is not unset:

src/datadog_api_client/v2/model/flaky_test_history.py

@@ -0,0 +1,45 @@
+# Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+# This product includes software developed at Datadog (https://www.datadoghq.com/).
+# Copyright 2019-Present Datadog, Inc.
+from __future__ import annotations
+
+
+from datadog_api_client.model_utils import (
+    ModelNormal,
+    cached_property,
+)
+
+
+class FlakyTestHistory(ModelNormal):
+    @cached_property
+    def openapi_types(_):
+        return {
+            "commit_sha": (str,),
+            "status": (str,),
+            "timestamp": (int,),
+        }
+
+    attribute_map = {
+        "commit_sha": "commit_sha",
+        "status": "status",
+        "timestamp": "timestamp",
+    }
+
+    def __init__(self_, commit_sha: str, status: str, timestamp: int, **kwargs):
+        """
+        A single history entry representing a status change for a flaky test.
+
+        :param commit_sha: The commit SHA associated with this status change. Will be an empty string if the commit SHA is not available.
+        :type commit_sha: str
+
+        :param status: The test status at this point in history.
+        :type status: str
+
+        :param timestamp: Unix timestamp in milliseconds when this status change occurred.
+        :type timestamp: int
+        """
+        super().__init__(kwargs)
+
+        self_.commit_sha = commit_sha
+        self_.status = status
+        self_.timestamp = timestamp

src/datadog_api_client/v2/model/flaky_tests_search_request_attributes.py

@@ -28,19 +28,22 @@ def openapi_types(_):
 
         return {
             "filter": (FlakyTestsSearchFilter,),
+            "include_history": (bool,),
             "page": (FlakyTestsSearchPageOptions,),
             "sort": (FlakyTestsSearchSort,),
         }
 
     attribute_map = {
         "filter": "filter",
+        "include_history": "include_history",
         "page": "page",
         "sort": "sort",
     }
 
     def __init__(
         self_,
         filter: Union[FlakyTestsSearchFilter, UnsetType] = unset,
+        include_history: Union[bool, UnsetType] = unset,
         page: Union[FlakyTestsSearchPageOptions, UnsetType] = unset,
         sort: Union[FlakyTestsSearchSort, UnsetType] = unset,
         **kwargs,
@@ -51,6 +54,11 @@ def __init__(
         :param filter: Search filter settings.
         :type filter: FlakyTestsSearchFilter, optional
 
+        :param include_history: Whether to include the status change history for each flaky test in the response.
+            When set to true, each test will include a ``history`` array with chronological status changes.
+            Defaults to false.
+        :type include_history: bool, optional
+
         :param page: Pagination attributes for listing flaky tests.
         :type page: FlakyTestsSearchPageOptions, optional
 
@@ -59,6 +67,8 @@ def __init__(
         """
         if filter is not unset:
             kwargs["filter"] = filter
+        if include_history is not unset:
+            kwargs["include_history"] = include_history
         if page is not unset:
             kwargs["page"] = page
         if sort is not unset:

src/datadog_api_client/v2/models/__init__.py

@@ -1971,6 +1971,7 @@
 from datadog_api_client.v2.model.flaky_test import FlakyTest
 from datadog_api_client.v2.model.flaky_test_attributes import FlakyTestAttributes
 from datadog_api_client.v2.model.flaky_test_attributes_flaky_state import FlakyTestAttributesFlakyState
+from datadog_api_client.v2.model.flaky_test_history import FlakyTestHistory
 from datadog_api_client.v2.model.flaky_test_pipeline_stats import FlakyTestPipelineStats
 from datadog_api_client.v2.model.flaky_test_run_metadata import FlakyTestRunMetadata
 from datadog_api_client.v2.model.flaky_test_stats import FlakyTestStats
@@ -7431,6 +7432,7 @@
     "FlakyTest",
     "FlakyTestAttributes",
     "FlakyTestAttributesFlakyState",
+    "FlakyTestHistory",
     "FlakyTestPipelineStats",
     "FlakyTestRunMetadata",
     "FlakyTestStats",