Regenerate client from commit 4fd1c189 of spec repo (#3196)

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

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

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-07-02 11:31:46.400598",
-            "spec_repo_commit": "ab77d015"
+            "regenerated": "2025-07-02 12:38:44.244057",
+            "spec_repo_commit": "4fd1c189"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-07-02 11:31:46.418602",
-            "spec_repo_commit": "ab77d015"
+            "regenerated": "2025-07-02 12:38:44.260658",
+            "spec_repo_commit": "4fd1c189"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -33427,6 +33427,86 @@ paths:
         operator: OR
         permissions:
         - synthetics_write
+  /api/v1/synthetics/tests/search:
+    get:
+      description: Search for Synthetic tests and Test Suites.
+      operationId: SearchTests
+      parameters:
+      - description: If true, include the full configuration for each test in the
+          response.
+        in: query
+        name: include_full_config
+        required: false
+        schema:
+          type: boolean
+      - description: If true, returns suites instead of tests.
+        in: query
+        name: search_suites
+        required: false
+        schema:
+          type: boolean
+      - description: If true, return only facets instead of full test details.
+        in: query
+        name: facets_only
+        required: false
+        schema:
+          type: boolean
+      - description: The offset from which to start returning results.
+        in: query
+        name: start
+        required: false
+        schema:
+          default: 0
+          format: int64
+          type: integer
+      - description: The maximum number of results to return.
+        in: query
+        name: count
+        required: false
+        schema:
+          default: 50
+          format: int64
+          type: integer
+      - description: The sort order for the results (e.g., 'name,asc' or 'name,desc').
+        in: query
+        name: sort
+        required: false
+        schema:
+          default: name,asc
+          type: string
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SyntheticsListTestsResponse'
+          description: OK - Returns the list of Synthetic tests matching the search.
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not found
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - synthetics_read
+      summary: Search Synthetic tests
+      tags:
+      - Synthetics
+      x-permission:
+        operator: OR
+        permissions:
+        - synthetics_read
   /api/v1/synthetics/tests/trigger:
     post:
       description: Trigger a set of Synthetic tests.
@@ -37222,13 +37302,21 @@ tags:
   name: Slack Integration
 - description: Take graph snapshots using the API.
   name: Snapshots
-- description: "Datadog Synthetic Monitoring uses simulated user requests and browser
-    rendering to help you ensure uptime,\nidentify regional issues, and track your
-    application performance. Synthetic tests come in\ntwo different flavors, [API
-    tests](https://docs.datadoghq.com/synthetics/api_tests/?tab=httptest)\nand [browser
-    tests](https://docs.datadoghq.com/synthetics/browser_tests). You can use Datadog\u2019s
-    API to\nmanage both test types programmatically.\n\nFor more information, see
-    the [Synthetic Monitoring documentation](https://docs.datadoghq.com/synthetics/)."
+- description: 'Datadog Synthetic Monitoring uses simulated user requests and browser
+    rendering to help you ensure uptime,
+
+    identify regional issues, and track your application performance. Synthetic tests
+    come in
+
+    two different flavors, [API tests](https://docs.datadoghq.com/synthetics/api_tests/?tab=httptest)
+
+    and [browser tests](https://docs.datadoghq.com/synthetics/browser_tests). You
+    can use Datadog''s API to
+
+    manage both test types programmatically.
+
+
+    For more information, see the [Synthetic Monitoring documentation](https://docs.datadoghq.com/synthetics/).'
   name: Synthetics
 - description: 'The tag endpoint allows you to assign tags to hosts,
 

api/datadogV1/api_synthetics.go

@@ -2062,6 +2062,154 @@ func (a *SyntheticsApi) PatchTest(ctx _context.Context, publicId string, body Sy
 	return localVarReturnValue, localVarHTTPResponse, nil
 }
 
+// SearchTestsOptionalParameters holds optional parameters for SearchTests.
+type SearchTestsOptionalParameters struct {
+	IncludeFullConfig *bool
+	SearchSuites      *bool
+	FacetsOnly        *bool
+	Start             *int64
+	Count             *int64
+	Sort              *string
+}
+
+// NewSearchTestsOptionalParameters creates an empty struct for parameters.
+func NewSearchTestsOptionalParameters() *SearchTestsOptionalParameters {
+	this := SearchTestsOptionalParameters{}
+	return &this
+}
+
+// WithIncludeFullConfig sets the corresponding parameter name and returns the struct.
+func (r *SearchTestsOptionalParameters) WithIncludeFullConfig(includeFullConfig bool) *SearchTestsOptionalParameters {
+	r.IncludeFullConfig = &includeFullConfig
+	return r
+}
+
+// WithSearchSuites sets the corresponding parameter name and returns the struct.
+func (r *SearchTestsOptionalParameters) WithSearchSuites(searchSuites bool) *SearchTestsOptionalParameters {
+	r.SearchSuites = &searchSuites
+	return r
+}
+
+// WithFacetsOnly sets the corresponding parameter name and returns the struct.
+func (r *SearchTestsOptionalParameters) WithFacetsOnly(facetsOnly bool) *SearchTestsOptionalParameters {
+	r.FacetsOnly = &facetsOnly
+	return r
+}
+
+// WithStart sets the corresponding parameter name and returns the struct.
+func (r *SearchTestsOptionalParameters) WithStart(start int64) *SearchTestsOptionalParameters {
+	r.Start = &start
+	return r
+}
+
+// WithCount sets the corresponding parameter name and returns the struct.
+func (r *SearchTestsOptionalParameters) WithCount(count int64) *SearchTestsOptionalParameters {
+	r.Count = &count
+	return r
+}
+
+// WithSort sets the corresponding parameter name and returns the struct.
+func (r *SearchTestsOptionalParameters) WithSort(sort string) *SearchTestsOptionalParameters {
+	r.Sort = &sort
+	return r
+}
+
+// SearchTests Search Synthetic tests.
+// Search for Synthetic tests and Test Suites.
+func (a *SyntheticsApi) SearchTests(ctx _context.Context, o ...SearchTestsOptionalParameters) (SyntheticsListTestsResponse, *_nethttp.Response, error) {
+	var (
+		localVarHTTPMethod  = _nethttp.MethodGet
+		localVarPostBody    interface{}
+		localVarReturnValue SyntheticsListTestsResponse
+		optionalParams      SearchTestsOptionalParameters
+	)
+
+	if len(o) > 1 {
+		return localVarReturnValue, nil, datadog.ReportError("only one argument of type SearchTestsOptionalParameters is allowed")
+	}
+	if len(o) == 1 {
+		optionalParams = o[0]
+	}
+
+	localBasePath, err := a.Client.Cfg.ServerURLWithContext(ctx, "v1.SyntheticsApi.SearchTests")
+	if err != nil {
+		return localVarReturnValue, nil, datadog.GenericOpenAPIError{ErrorMessage: err.Error()}
+	}
+
+	localVarPath := localBasePath + "/api/v1/synthetics/tests/search"
+
+	localVarHeaderParams := make(map[string]string)
+	localVarQueryParams := _neturl.Values{}
+	localVarFormParams := _neturl.Values{}
+	if optionalParams.IncludeFullConfig != nil {
+		localVarQueryParams.Add("include_full_config", datadog.ParameterToString(*optionalParams.IncludeFullConfig, ""))
+	}
+	if optionalParams.SearchSuites != nil {
+		localVarQueryParams.Add("search_suites", datadog.ParameterToString(*optionalParams.SearchSuites, ""))
+	}
+	if optionalParams.FacetsOnly != nil {
+		localVarQueryParams.Add("facets_only", datadog.ParameterToString(*optionalParams.FacetsOnly, ""))
+	}
+	if optionalParams.Start != nil {
+		localVarQueryParams.Add("start", datadog.ParameterToString(*optionalParams.Start, ""))
+	}
+	if optionalParams.Count != nil {
+		localVarQueryParams.Add("count", datadog.ParameterToString(*optionalParams.Count, ""))
+	}
+	if optionalParams.Sort != nil {
+		localVarQueryParams.Add("sort", datadog.ParameterToString(*optionalParams.Sort, ""))
+	}
+	localVarHeaderParams["Accept"] = "application/json"
+
+	datadog.SetAuthKeys(
+		ctx,
+		&localVarHeaderParams,
+		[2]string{"apiKeyAuth", "DD-API-KEY"},
+		[2]string{"appKeyAuth", "DD-APPLICATION-KEY"},
+	)
+	req, err := a.Client.PrepareRequest(ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, nil)
+	if err != nil {
+		return localVarReturnValue, nil, err
+	}
+
+	localVarHTTPResponse, err := a.Client.CallAPI(req)
+	if err != nil || localVarHTTPResponse == nil {
+		return localVarReturnValue, localVarHTTPResponse, err
+	}
+
+	localVarBody, err := datadog.ReadBody(localVarHTTPResponse)
+	if err != nil {
+		return localVarReturnValue, localVarHTTPResponse, err
+	}
+
+	if localVarHTTPResponse.StatusCode >= 300 {
+		newErr := datadog.GenericOpenAPIError{
+			ErrorBody:    localVarBody,
+			ErrorMessage: localVarHTTPResponse.Status,
+		}
+		if localVarHTTPResponse.StatusCode == 403 || localVarHTTPResponse.StatusCode == 404 || localVarHTTPResponse.StatusCode == 429 {
+			var v APIErrorResponse
+			err = a.Client.Decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
+			if err != nil {
+				return localVarReturnValue, localVarHTTPResponse, newErr
+			}
+			newErr.ErrorModel = v
+		}
+		return localVarReturnValue, localVarHTTPResponse, newErr
+	}
+
+	err = a.Client.Decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
+	if err != nil {
+		newErr := datadog.GenericOpenAPIError{
+			ErrorBody:    localVarBody,
+			ErrorMessage: err.Error(),
+		}
+		return localVarReturnValue, localVarHTTPResponse, newErr
+	}
+
+	return localVarReturnValue, localVarHTTPResponse, nil
+}
+
 // TriggerCITests Trigger tests from CI/CD pipelines.
 // Trigger a set of Synthetic tests for continuous integration.
 func (a *SyntheticsApi) TriggerCITests(ctx _context.Context, body SyntheticsCITestBody) (SyntheticsTriggerCITestsResponse, *_nethttp.Response, error) {

api/datadogV1/doc.go

@@ -175,6 +175,7 @@
 //   - [SyntheticsApi.ListLocations]
 //   - [SyntheticsApi.ListTests]
 //   - [SyntheticsApi.PatchTest]
+//   - [SyntheticsApi.SearchTests]
 //   - [SyntheticsApi.TriggerCITests]
 //   - [SyntheticsApi.TriggerTests]
 //   - [SyntheticsApi.UpdateAPITest]

examples/v1/synthetics/SearchTests.go

@@ -0,0 +1,29 @@
+// Search Synthetic tests returns "OK - Returns the list of Synthetic tests matching the search." response
+
+package main
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"os"
+
+	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
+	"github.com/DataDog/datadog-api-client-go/v2/api/datadogV1"
+)
+
+func main() {
+	ctx := datadog.NewDefaultContext(context.Background())
+	configuration := datadog.NewConfiguration()
+	apiClient := datadog.NewAPIClient(configuration)
+	api := datadogV1.NewSyntheticsApi(apiClient)
+	resp, r, err := api.SearchTests(ctx, *datadogV1.NewSearchTestsOptionalParameters())
+
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Error when calling `SyntheticsApi.SearchTests`: %v\n", err)
+		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
+	}
+
+	responseContent, _ := json.MarshalIndent(resp, "", "  ")
+	fmt.Fprintf(os.Stdout, "Response from `SyntheticsApi.SearchTests`:\n%s\n", responseContent)
+}

examples/v1/synthetics/SearchTests_195957771.go

@@ -0,0 +1,29 @@
+// Search Synthetic tests with boolean query parameters
+
+package main
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"os"
+
+	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
+	"github.com/DataDog/datadog-api-client-go/v2/api/datadogV1"
+)
+
+func main() {
+	ctx := datadog.NewDefaultContext(context.Background())
+	configuration := datadog.NewConfiguration()
+	apiClient := datadog.NewAPIClient(configuration)
+	api := datadogV1.NewSyntheticsApi(apiClient)
+	resp, r, err := api.SearchTests(ctx, *datadogV1.NewSearchTestsOptionalParameters().WithIncludeFullConfig(true).WithSearchSuites(true).WithFacetsOnly(true).WithStart(10).WithCount(5).WithSort("name,desc"))
+
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Error when calling `SyntheticsApi.SearchTests`: %v\n", err)
+		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
+	}
+
+	responseContent, _ := json.MarshalIndent(resp, "", "  ")
+	fmt.Fprintf(os.Stdout, "Response from `SyntheticsApi.SearchTests`:\n%s\n", responseContent)
+}

tests/scenarios/cassettes/TestScenarios/v1/Feature_Synthetics/Scenario_Search_Synthetic_tests_with_boolean_query_parameters.freeze

@@ -0,0 +1 @@
+2025-07-01T15:52:56.329Z

tests/scenarios/cassettes/TestScenarios/v1/Feature_Synthetics/Scenario_Search_Synthetic_tests_with_boolean_query_parameters.yaml

@@ -0,0 +1,19 @@
+interactions:
+- request:
+    body: ''
+    form: {}
+    headers:
+      Accept:
+      - application/json
+    id: 0
+    method: GET
+    url: https://api.datadoghq.com/api/v1/synthetics/tests/search?include_full_config=true&search_suites=true&facets_only=true&start=10&count=5&sort=name%2Cdesc
+  response:
+    body: '{"tests":[],"total":0,"facets":[]}'
+    code: 200
+    duration: 0ms
+    headers:
+      Content-Type:
+      - application/json
+    status: 200 OK
+version: 2

tests/scenarios/cassettes/TestScenarios/v1/Feature_Synthetics/Scenario_Trigger_Synthetic_tests_returns_OK_response.freeze

@@ -1 +1 @@
-2024-12-09T11:18:22.632Z
+2025-07-01T15:52:56.929Z