Add Synthetics suites CRUD endpoints (#3316)

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

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

.generator/schemas/v2/openapi.yaml

@@ -0,0 +1 @@
+"2026-01-07T12:38:44.484Z"

cassettes/v2/Synthetics_2658572017/Search-Synthetics-suites-returns-OK-response_3502591370/frozen.json

@@ -0,0 +1,57 @@
+{
+  "log": {
+    "_recordingName": "Synthetics/Search Synthetics suites returns \"OK\" response",
+    "creator": {
+      "comment": "persister:fs",
+      "name": "Polly.JS",
+      "version": "6.0.5"
+    },
+    "entries": [
+      {
+        "_id": "36af715dc1b113ae5f987d3ee44b564b",
+        "_order": 0,
+        "cache": {},
+        "request": {
+          "bodySize": 0,
+          "cookies": [],
+          "headers": [
+            {
+              "_fromType": "array",
+              "name": "accept",
+              "value": "application/json"
+            }
+          ],
+          "headersSize": 517,
+          "httpVersion": "HTTP/1.1",
+          "method": "GET",
+          "queryString": [],
+          "url": "https://api.datadoghq.com/api/v2/synthetics/suites/search"
+        },
+        "response": {
+          "bodySize": 8678,
+          "content": {
+            "mimeType": "application/json",
+            "size": 8678,
+            "text": "{\"data\":{\"type\":\"suites_search\",\"attributes\":{\"suites\":[{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2025-12-12T14:36:38.194974+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1765550180,\"monitor_id\":243683630,\"tests\":[],\"notifications\":[],\"public_id\":\"q9j-u8p-3v5\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2025-12-12T15:13:58.194856+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1765552435,\"monitor_id\":243691225,\"tests\":[],\"notifications\":[],\"public_id\":\"qqj-ma8-msw\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2025-12-12T13:58:21.265235+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1765547882,\"monitor_id\":243678032,\"tests\":[],\"notifications\":[],\"public_id\":\"qwt-zcd-3e7\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2025-12-16T21:23:27.482218+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1765920189,\"monitor_id\":244824489,\"tests\":[],\"notifications\":[],\"public_id\":\"yya-xnv-r72\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2026-01-06T14:31:13.144659+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1767709878,\"monitor_id\":248911428,\"tests\":[],\"notifications\":[],\"public_id\":\"37x-cfh-hik\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2025-12-12T14:52:23.813142+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1765551141,\"monitor_id\":243686361,\"tests\":[],\"notifications\":[],\"public_id\":\"y9a-9jy-ng2\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2025-12-15T14:02:40.227969+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1765807338,\"monitor_id\":244243608,\"tests\":[],\"notifications\":[],\"public_id\":\"45f-82u-p2d\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2025-12-15T14:22:09.594574+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1765808505,\"monitor_id\":244250055,\"tests\":[],\"notifications\":[],\"public_id\":\"xd9-dws-cm2\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2025-12-15T15:36:44.135107+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1765813000,\"monitor_id\":244276690,\"tests\":[],\"notifications\":[],\"public_id\":\"77s-9gi-8pa\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2025-12-16T09:42:02.245892+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1765878101,\"monitor_id\":244658021,\"tests\":[],\"notifications\":[],\"public_id\":\"xft-zns-y58\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2025-12-16T09:52:14.327958+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1765878721,\"monitor_id\":244659781,\"tests\":[],\"notifications\":[],\"public_id\":\"9ne-jp8-bbs\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2025-12-19T09:34:53.578670+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1766136882,\"monitor_id\":245439882,\"tests\":[],\"notifications\":[],\"public_id\":\"rcp-hsx-ksp\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2025-12-09T10:37:16.189540+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1765276630,\"monitor_id\":242864230,\"tests\":[],\"notifications\":[],\"public_id\":\"ihb-7cb-mbq\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2025-12-12T14:58:39.394977+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1765551515,\"monitor_id\":243687635,\"tests\":[],\"notifications\":[],\"public_id\":\"m4t-g9e-cht\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2025-12-15T13:27:01.650049+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1765805206,\"monitor_id\":244230166,\"tests\":[],\"notifications\":[],\"public_id\":\"3rn-xv7-3gw\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2025-12-15T13:55:29.070758+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1765806925,\"monitor_id\":244240495,\"tests\":[],\"notifications\":[],\"public_id\":\"u5z-r6t-6gj\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2025-12-15T15:48:08.393886+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1765813664,\"monitor_id\":244283444,\"tests\":[],\"notifications\":[],\"public_id\":\"fug-wqb-jgm\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2025-12-17T08:57:02.235129+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1765961806,\"monitor_id\":244953226,\"tests\":[],\"notifications\":[],\"public_id\":\"tmj-mmm-6rw\",\"tags\":[\"env:production\"]},{\"created_by\":{\"name\":\"CI Account\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\"},\"monitor_status\":\"No Data\",\"type\":\"suite\",\"modified_at\":\"2026-01-06T13:52:15.675454+00:00\",\"name\":\"Example suite name\",\"options\":{},\"monitor_name\":\"[Synthetics] Example suite name\",\"last_triggered_ts\":1767707530,\"monitor_id\":248904310,\"tests\":[],\"notifications\":[],\"public_id\":\"pkr-4b7-tug\",\"tags\":[\"env:production\"]}],\"facets\":[{\"name\":\"mobile_platform\",\"values\":[]},{\"name\":\"test_count\",\"values\":[{\"name\":\"0\",\"count\":19}]},{\"name\":\"step_count\",\"values\":[]},{\"name\":\"http_path\",\"values\":[]},{\"name\":\"team\",\"values\":[]},{\"name\":\"type\",\"values\":[{\"name\":\"suite\",\"count\":19}]},{\"name\":\"env\",\"values\":[{\"name\":\"production\",\"count\":19}]},{\"name\":\"creator\",\"values\":[{\"name\":\"CI Account\",\"count\":19}]},{\"name\":\"mobile_application\",\"values\":[]},{\"name\":\"notification\",\"values\":[]},{\"name\":\"endpoint\",\"values\":[]},{\"name\":\"http_method\",\"values\":[]},{\"name\":\"creation_source\",\"values\":[]},{\"name\":\"domain\",\"values\":[]},{\"name\":\"ci_execution_rule\",\"values\":[{\"name\":\"blocking\",\"count\":19}]},{\"name\":\"tag\",\"values\":[{\"name\":\"env:production\",\"count\":19}]},{\"name\":\"state\",\"values\":[{\"name\":\"paused\",\"count\":19}]},{\"name\":\"region\",\"values\":[]},{\"name\":\"muted\",\"values\":[{\"name\":\"0\",\"count\":19}]},{\"name\":\"status\",\"values\":[{\"name\":\"No Data\",\"count\":19}]}],\"total\":19},\"id\":\"74278a23-c9ce-4093-816d-7109fb05adb5\"}}\n"
+          },
+          "cookies": [],
+          "headers": [
+            {
+              "name": "content-type",
+              "value": "application/json"
+            }
+          ],
+          "headersSize": 695,
+          "httpVersion": "HTTP/1.1",
+          "redirectURL": "",
+          "status": 200,
+          "statusText": "OK"
+        },
+        "startedDateTime": "2026-01-07T12:38:45.337Z",
+        "time": 366
+      }
+    ],
+    "pages": [],
+    "version": "1.2"
+  }
+}

cassettes/v2/Synthetics_2658572017/Search-Synthetics-suites-returns-OK-response_3502591370/recording.har

@@ -0,0 +1 @@
+"2026-01-07T12:38:45.716Z"

cassettes/v2/Synthetics_2658572017/Synthetics-Create-a-test-suite-returns-OK-response_1408524926/frozen.json

@@ -0,0 +1,120 @@
+{
+  "log": {
+    "_recordingName": "Synthetics/Synthetics: Create a test suite returns \"OK\" response",
+    "creator": {
+      "comment": "persister:fs",
+      "name": "Polly.JS",
+      "version": "6.0.5"
+    },
+    "entries": [
+      {
+        "_id": "28246ef14beb75930aef1feb4367b252",
+        "_order": 0,
+        "cache": {},
+        "request": {
+          "bodySize": 167,
+          "cookies": [],
+          "headers": [
+            {
+              "_fromType": "array",
+              "name": "accept",
+              "value": "application/json"
+            },
+            {
+              "_fromType": "array",
+              "name": "content-type",
+              "value": "application/json"
+            }
+          ],
+          "headersSize": 572,
+          "httpVersion": "HTTP/1.1",
+          "method": "POST",
+          "postData": {
+            "mimeType": "application/json",
+            "params": [],
+            "text": "{\"data\":{\"attributes\":{\"message\":\"Notification message\",\"name\":\"Example suite name\",\"options\":{},\"tags\":[\"env:production\"],\"tests\":[],\"type\":\"suite\"},\"type\":\"suites\"}}"
+          },
+          "queryString": [],
+          "url": "https://api.datadoghq.com/api/v2/synthetics/suites"
+        },
+        "response": {
+          "bodySize": 616,
+          "content": {
+            "mimeType": "application/json",
+            "size": 616,
+            "text": "{\"data\":{\"type\":\"suites\",\"id\":\"36n-bb6-njj\",\"attributes\":{\"tags\":[\"env:production\"],\"type\":\"suite\",\"created_by\":{\"email\":\"team-intg-tools-libs-spam@datadoghq.com\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\",\"name\":\"CI Account\"},\"created_at\":\"2026-01-07T12:38:46.109472+00:00\",\"modified_at\":\"2026-01-07T12:38:46.109472+00:00\",\"message\":\"Notification message\",\"public_id\":\"36n-bb6-njj\",\"options\":{},\"modified_by\":{\"email\":\"team-intg-tools-libs-spam@datadoghq.com\",\"handle\":\"9919ec9b-ebc7-49ee-8dc8-03626e717cca\",\"name\":\"CI Account\"},\"tests\":[],\"name\":\"Example suite name\",\"org_id\":321813,\"monitor_id\":249141773}}}\n"
+          },
+          "cookies": [],
+          "headers": [
+            {
+              "name": "content-type",
+              "value": "application/json"
+            }
+          ],
+          "headersSize": 693,
+          "httpVersion": "HTTP/1.1",
+          "redirectURL": "",
+          "status": 200,
+          "statusText": "OK"
+        },
+        "startedDateTime": "2026-01-07T12:38:45.719Z",
+        "time": 491
+      },
+      {
+        "_id": "1bd5428beb451f07ea8ab3d0bc71b1e8",
+        "_order": 0,
+        "cache": {},
+        "request": {
+          "bodySize": 85,
+          "cookies": [],
+          "headers": [
+            {
+              "_fromType": "array",
+              "name": "accept",
+              "value": "application/json"
+            },
+            {
+              "_fromType": "array",
+              "name": "content-type",
+              "value": "application/json"
+            }
+          ],
+          "headersSize": 584,
+          "httpVersion": "HTTP/1.1",
+          "method": "POST",
+          "postData": {
+            "mimeType": "application/json",
+            "params": [],
+            "text": "{\"data\":{\"attributes\":{\"public_ids\":[\"36n-bb6-njj\"]},\"type\":\"delete_suites_request\"}}"
+          },
+          "queryString": [],
+          "url": "https://api.datadoghq.com/api/v2/synthetics/suites/bulk-delete"
+        },
+        "response": {
+          "bodySize": 131,
+          "content": {
+            "mimeType": "application/json",
+            "size": 131,
+            "text": "{\"data\":[{\"type\":\"suites\",\"attributes\":{\"public_id\":\"36n-bb6-njj\",\"deleted_at\":\"2026-01-07 12:38:46.679914\"},\"id\":\"36n-bb6-njj\"}]}\n"
+          },
+          "cookies": [],
+          "headers": [
+            {
+              "name": "content-type",
+              "value": "application/json"
+            }
+          ],
+          "headersSize": 694,
+          "httpVersion": "HTTP/1.1",
+          "redirectURL": "",
+          "status": 200,
+          "statusText": "OK"
+        },
+        "startedDateTime": "2026-01-07T12:38:46.218Z",
+        "time": 739
+      }
+    ],
+    "pages": [],
+    "version": "1.2"
+  }
+}

cassettes/v2/Synthetics_2658572017/Synthetics-Create-a-test-suite-returns-OK-response_1408524926/recording.har

@@ -51,3 +51,73 @@ Feature: Synthetics
     When the request is sent
     Then the response status is 200 OK
     And the response "data.attributes.on_demand_concurrency_cap" is equal to 20
+
+  @generated @skip @team:DataDog/synthetics-managing
+  Scenario: Search Synthetics suites returns "API error response." response
+    Given new "SearchSuites" request
+    When the request is sent
+    Then the response status is 400 API error response.
+
+  @team:DataDog/synthetics-managing
+  Scenario: Search Synthetics suites returns "OK" response
+    Given new "SearchSuites" request
+    When the request is sent
+    Then the response status is 200 OK
+
+  @generated @skip @team:DataDog/synthetics-managing
+  Scenario: Synthetics: Bulk delete suites returns "API error response." response
+    Given new "DeleteSyntheticsSuites" request
+    And body with value {"data": {"attributes": {"public_ids": [""]}, "type": "delete_suites_request"}}
+    When the request is sent
+    Then the response status is 400 API error response.
+
+  @generated @skip @team:DataDog/synthetics-managing
+  Scenario: Synthetics: Bulk delete suites returns "OK" response
+    Given new "DeleteSyntheticsSuites" request
+    And body with value {"data": {"attributes": {"public_ids": [""]}, "type": "delete_suites_request"}}
+    When the request is sent
+    Then the response status is 200 OK
+
+  @generated @skip @team:DataDog/synthetics-managing
+  Scenario: Synthetics: Create a test suite returns "API error response." response
+    Given new "CreateSyntheticsSuite" request
+    And body with value {"data": {"attributes": {"message": "Notification message", "name": "Example suite name", "options": {}, "tags": ["env:production"], "tests": [{"alerting_criticality": "critical", "public_id": ""}], "type": "suite"}, "type": "suites"}}
+    When the request is sent
+    Then the response status is 400 API error response.
+
+  @team:DataDog/synthetics-managing
+  Scenario: Synthetics: Create a test suite returns "OK" response
+    Given new "CreateSyntheticsSuite" request
+    And body with value {"data": {"attributes": {"message": "Notification message", "name": "Example suite name", "options": {}, "tags": ["env:production"], "tests": [], "type": "suite"}, "type": "suites"}}
+    When the request is sent
+    Then the response status is 200 OK
+
+  @generated @skip @team:DataDog/synthetics-managing
+  Scenario: Synthetics: Edit a test suite returns "API error response." response
+    Given new "EditSyntheticsSuite" request
+    And request contains "public_id" parameter from "REPLACE.ME"
+    And body with value {"data": {"attributes": {"message": "Notification message", "name": "Example suite name", "options": {}, "tags": ["env:production"], "tests": [{"alerting_criticality": "critical", "public_id": ""}], "type": "suite"}, "type": "suites"}}
+    When the request is sent
+    Then the response status is 400 API error response.
+
+  @generated @skip @team:DataDog/synthetics-managing
+  Scenario: Synthetics: Edit a test suite returns "OK" response
+    Given new "EditSyntheticsSuite" request
+    And request contains "public_id" parameter from "REPLACE.ME"
+    And body with value {"data": {"attributes": {"message": "Notification message", "name": "Example suite name", "options": {}, "tags": ["env:production"], "tests": [{"alerting_criticality": "critical", "public_id": ""}], "type": "suite"}, "type": "suites"}}
+    When the request is sent
+    Then the response status is 200 OK
+
+  @generated @skip @team:DataDog/synthetics-managing
+  Scenario: Synthetics: Get a suite returns "API error response." response
+    Given new "GetSyntheticsSuite" request
+    And request contains "public_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 404 API error response.
+
+  @generated @skip @team:DataDog/synthetics-managing
+  Scenario: Synthetics: Get a suite returns "OK" response
+    Given new "GetSyntheticsSuite" request
+    And request contains "public_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 200 OK