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

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:

examples/v2/test-optimization/SearchFlakyTests.rb

@@ -12,6 +12,7 @@
       filter: DatadogAPIClient::V2::FlakyTestsSearchFilter.new({
         query: 'flaky_test_state:active @git.repository.id_v2:"github.com/datadog/shopist"',
       }),
+      include_history: true,
       page: DatadogAPIClient::V2::FlakyTestsSearchPageOptions.new({
         cursor: "eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==",
         limit: 25,

examples/v2/test-optimization/SearchFlakyTests_1224086727.rb

@@ -12,6 +12,7 @@
       filter: DatadogAPIClient::V2::FlakyTestsSearchFilter.new({
         query: 'flaky_test_state:active @git.repository.id_v2:"github.com/datadog/shopist"',
       }),
+      include_history: true,
       page: DatadogAPIClient::V2::FlakyTestsSearchPageOptions.new({
         cursor: "eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==",
         limit: 25,

examples/v2/test-optimization/SearchFlakyTests_209064879.rb

@@ -0,0 +1,27 @@
+# Search flaky tests returns "OK" response with history
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.search_flaky_tests".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::TestOptimizationAPI.new
+
+body = DatadogAPIClient::V2::FlakyTestsSearchRequest.new({
+  data: DatadogAPIClient::V2::FlakyTestsSearchRequestData.new({
+    attributes: DatadogAPIClient::V2::FlakyTestsSearchRequestAttributes.new({
+      filter: DatadogAPIClient::V2::FlakyTestsSearchFilter.new({
+        query: 'flaky_test_state:active @git.repository.id_v2:"github.com/datadog/shopist"',
+      }),
+      page: DatadogAPIClient::V2::FlakyTestsSearchPageOptions.new({
+        limit: 10,
+      }),
+      sort: DatadogAPIClient::V2::FlakyTestsSearchSort::FQN_ASCENDING,
+      include_history: true,
+    }),
+    type: DatadogAPIClient::V2::FlakyTestsSearchRequestDataType::SEARCH_FLAKY_TESTS_REQUEST,
+  }),
+})
+opts = {
+  body: body,
+}
+p api_instance.search_flaky_tests(opts)

features/v2/test_optimization.feature

@@ -13,7 +13,7 @@ Feature: Test Optimization
   Scenario: Search flaky tests returns "Bad Request" response
     Given operation "SearchFlakyTests" enabled
     And new "SearchFlakyTests" request
-    And body with value {"data": {"attributes": {"filter": {"query": "flaky_test_state:active @git.repository.id_v2:\"github.com/datadog/shopist\""}, "page": {"cursor": "eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==", "limit": 25}, "sort": "failure_rate"}, "type": "search_flaky_tests_request"}}
+    And body with value {"data": {"attributes": {"filter": {"query": "flaky_test_state:active @git.repository.id_v2:\"github.com/datadog/shopist\""}, "include_history": true, "page": {"cursor": "eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==", "limit": 25}, "sort": "failure_rate"}, "type": "search_flaky_tests_request"}}
     When the request is sent
     Then the response status is 400 Bad Request
 
@@ -29,7 +29,7 @@ Feature: Test Optimization
   Scenario: Search flaky tests returns "OK" response
     Given operation "SearchFlakyTests" enabled
     And new "SearchFlakyTests" request
-    And body with value {"data": {"attributes": {"filter": {"query": "flaky_test_state:active @git.repository.id_v2:\"github.com/datadog/shopist\""}, "page": {"cursor": "eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==", "limit": 25}, "sort": "failure_rate"}, "type": "search_flaky_tests_request"}}
+    And body with value {"data": {"attributes": {"filter": {"query": "flaky_test_state:active @git.repository.id_v2:\"github.com/datadog/shopist\""}, "include_history": true, "page": {"cursor": "eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==", "limit": 25}, "sort": "failure_rate"}, "type": "search_flaky_tests_request"}}
     When the request is sent
     Then the response status is 200 OK
 
@@ -41,11 +41,23 @@ Feature: Test Optimization
     When the request with pagination is sent
     Then the response status is 200 OK
 
+  @skip @team:DataDog/ci-app-backend
+  Scenario: Search flaky tests returns "OK" response with history
+    Given operation "SearchFlakyTests" enabled
+    And new "SearchFlakyTests" request
+    And body with value {"data": {"attributes": {"filter": {"query": "flaky_test_state:active @git.repository.id_v2:\"github.com/datadog/shopist\""}, "page": {"limit": 10}, "sort": "fqn", "include_history": true}, "type": "search_flaky_tests_request"}}
+    When the request is sent
+    Then the response status is 200 OK
+    And the response "data[0].attributes" has field "history"
+    And the response "data[0].attributes.history[0]" has field "status"
+    And the response "data[0].attributes.history[0]" has field "commit_sha"
+    And the response "data[0].attributes.history[0]" has field "timestamp"
+
   @generated @skip @team:DataDog/ci-app-backend @with-pagination
   Scenario: Search flaky tests returns "OK" response with pagination
     Given operation "SearchFlakyTests" enabled
     And new "SearchFlakyTests" request
-    And body with value {"data": {"attributes": {"filter": {"query": "flaky_test_state:active @git.repository.id_v2:\"github.com/datadog/shopist\""}, "page": {"cursor": "eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==", "limit": 25}, "sort": "failure_rate"}, "type": "search_flaky_tests_request"}}
+    And body with value {"data": {"attributes": {"filter": {"query": "flaky_test_state:active @git.repository.id_v2:\"github.com/datadog/shopist\""}, "include_history": true, "page": {"cursor": "eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==", "limit": 25}, "sort": "failure_rate"}, "type": "search_flaky_tests_request"}}
     When the request with pagination is sent
     Then the response status is 200 OK
 

lib/datadog_api_client/inflector.rb

@@ -2408,6 +2408,7 @@ def overrides
           "v2.flaky_test" => "FlakyTest",
           "v2.flaky_test_attributes" => "FlakyTestAttributes",
           "v2.flaky_test_attributes_flaky_state" => "FlakyTestAttributesFlakyState",
+          "v2.flaky_test_history" => "FlakyTestHistory",
           "v2.flaky_test_pipeline_stats" => "FlakyTestPipelineStats",
           "v2.flaky_test_run_metadata" => "FlakyTestRunMetadata",
           "v2.flaky_tests_pagination" => "FlakyTestsPagination",

lib/datadog_api_client/v2/api/test_optimization_api.rb

@@ -35,6 +35,19 @@ def search_flaky_tests(opts = {})
     #
     # 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.
+    #
     # @param opts [Hash] the optional parameters
     # @option opts [FlakyTestsSearchRequest] :body 
     # @return [Array<(FlakyTestsSearchResponse, Integer, Hash)>] FlakyTestsSearchResponse data, response status code and response headers

lib/datadog_api_client/v2/models/flaky_test_attributes.rb

@@ -48,6 +48,10 @@ class FlakyTestAttributes
     # The current state of the flaky test.
     attr_accessor :flaky_state
 
+    # 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.
+    attr_accessor :history
+
     # The branch name where the test exhibited flakiness for the last time.
     attr_accessor :last_flaked_branch
 
@@ -100,6 +104,7 @@ def self.attribute_map
         :'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',
@@ -125,6 +130,7 @@ def self.openapi_types
         :'first_flaked_ts' => :'Integer',
         :'flaky_category' => :'String',
         :'flaky_state' => :'FlakyTestAttributesFlakyState',
+        :'history' => :'Array<FlakyTestHistory>',
         :'last_flaked_branch' => :'String',
         :'last_flaked_sha' => :'String',
         :'last_flaked_ts' => :'Integer',
@@ -201,6 +207,12 @@ def initialize(attributes = {})
         self.flaky_state = attributes[:'flaky_state']
       end
 
+      if attributes.key?(:'history')
+        if (value = attributes[:'history']).is_a?(Array)
+          self.history = value
+        end
+      end
+
       if attributes.key?(:'last_flaked_branch')
         self.last_flaked_branch = attributes[:'last_flaked_branch']
       end
@@ -278,6 +290,7 @@ def ==(o)
           first_flaked_ts == o.first_flaked_ts &&
           flaky_category == o.flaky_category &&
           flaky_state == o.flaky_state &&
+          history == o.history &&
           last_flaked_branch == o.last_flaked_branch &&
           last_flaked_sha == o.last_flaked_sha &&
           last_flaked_ts == o.last_flaked_ts &&
@@ -295,7 +308,7 @@ def ==(o)
     # @return [Integer] Hash code
     # @!visibility private
     def hash
-      [attempt_to_fix_id, codeowners, envs, first_flaked_branch, first_flaked_sha, first_flaked_ts, flaky_category, flaky_state, last_flaked_branch, last_flaked_sha, last_flaked_ts, _module, name, pipeline_stats, services, suite, test_run_metadata, test_stats, additional_properties].hash
+      [attempt_to_fix_id, codeowners, envs, first_flaked_branch, first_flaked_sha, first_flaked_ts, flaky_category, flaky_state, history, last_flaked_branch, last_flaked_sha, last_flaked_ts, _module, name, pipeline_stats, services, suite, test_run_metadata, test_stats, additional_properties].hash
     end
   end
 end