Add OpenAPI documentation for security monitoring signals investigation endpoints

examples/v2/security-monitoring/CreateSignalInvestigation.java

@@ -0,0 +1,40 @@
+// Create a security signal investigation returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.SecurityMonitoringApi;
+import com.datadog.api.client.v2.model.SecurityMonitoringSignalInvestigationRequest;
+import com.datadog.api.client.v2.model.SecurityMonitoringSignalInvestigationRequestAttributes;
+import com.datadog.api.client.v2.model.SecurityMonitoringSignalInvestigationRequestData;
+import com.datadog.api.client.v2.model.SecurityMonitoringSignalInvestigationResponse;
+import com.datadog.api.client.v2.model.SecurityMonitoringSignalInvestigationType;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.createSignalInvestigation", true);
+    SecurityMonitoringApi apiInstance = new SecurityMonitoringApi(defaultClient);
+
+    SecurityMonitoringSignalInvestigationRequest body =
+        new SecurityMonitoringSignalInvestigationRequest()
+            .data(
+                new SecurityMonitoringSignalInvestigationRequestData()
+                    .attributes(
+                        new SecurityMonitoringSignalInvestigationRequestAttributes()
+                            .deployment("live")
+                            .signalId("AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA"))
+                    .type(SecurityMonitoringSignalInvestigationType.INVESTIGATION_SIGNAL));
+
+    try {
+      SecurityMonitoringSignalInvestigationResponse result =
+          apiInstance.createSignalInvestigation(body);
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling SecurityMonitoringApi#createSignalInvestigation");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/security-monitoring/GetInvestigationFeedback.java

@@ -0,0 +1,26 @@
+// Get investigation feedback returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.SecurityMonitoringApi;
+import com.datadog.api.client.v2.model.SecurityMonitoringSignalInvestigationFeedbackResponse;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.getInvestigationFeedback", true);
+    SecurityMonitoringApi apiInstance = new SecurityMonitoringApi(defaultClient);
+
+    try {
+      SecurityMonitoringSignalInvestigationFeedbackResponse result =
+          apiInstance.getInvestigationFeedback("signal_id");
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling SecurityMonitoringApi#getInvestigationFeedback");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

examples/v2/security-monitoring/UpdateInvestigationFeedback.java

@@ -0,0 +1,57 @@
+// Update investigation feedback returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.SecurityMonitoringApi;
+import com.datadog.api.client.v2.model.SecurityMonitoringSignalInvestigationFeedbackMetric;
+import com.datadog.api.client.v2.model.SecurityMonitoringSignalInvestigationFeedbackRequest;
+import com.datadog.api.client.v2.model.SecurityMonitoringSignalInvestigationFeedbackRequestAttributes;
+import com.datadog.api.client.v2.model.SecurityMonitoringSignalInvestigationFeedbackRequestData;
+import com.datadog.api.client.v2.model.SecurityMonitoringSignalInvestigationFeedbackSection;
+import com.datadog.api.client.v2.model.SecurityMonitoringSignalInvestigationFeedbackType;
+import java.util.Collections;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.updateInvestigationFeedback", true);
+    SecurityMonitoringApi apiInstance = new SecurityMonitoringApi(defaultClient);
+
+    SecurityMonitoringSignalInvestigationFeedbackRequest body =
+        new SecurityMonitoringSignalInvestigationFeedbackRequest()
+            .data(
+                new SecurityMonitoringSignalInvestigationFeedbackRequestData()
+                    .attributes(
+                        new SecurityMonitoringSignalInvestigationFeedbackRequestAttributes()
+                            .feedback("positive")
+                            .feedbackContent(
+                                Collections.singletonList(
+                                    new SecurityMonitoringSignalInvestigationFeedbackSection()
+                                        .id("section-1")
+                                        .metrics(
+                                            Collections.singletonList(
+                                                new SecurityMonitoringSignalInvestigationFeedbackMetric()
+                                                    .placeholder("Enter your feedback here")
+                                                    .prompt("How helpful was this investigation?")
+                                                    .response("Very helpful")
+                                                    .type("sentiment")))
+                                        .title("Investigation Quality")))
+                            .incomplete(false)
+                            .rating("positive")
+                            .signalId("AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA")
+                            .type("metrics"))
+                    .type(
+                        SecurityMonitoringSignalInvestigationFeedbackType.INVESTIGATION_FEEDBACK));
+
+    try {
+      apiInstance.updateInvestigationFeedback(body);
+    } catch (ApiException e) {
+      System.err.println(
+          "Exception when calling SecurityMonitoringApi#updateInvestigationFeedback");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

src/main/java/com/datadog/api/client/ApiClient.java

@@ -777,8 +777,10 @@ public class ApiClient {
           put("v2.updateOpenAPI", false);
           put("v2.cancelThreatHuntingJob", false);
           put("v2.convertJobResultToSignal", false);
+          put("v2.createSignalInvestigation", false);
           put("v2.deleteThreatHuntingJob", false);
           put("v2.getFinding", false);
+          put("v2.getInvestigationFeedback", false);
           put("v2.getRuleVersionHistory", false);
           put("v2.getSecretsRules", false);
           put("v2.getSecurityMonitoringHistsignal", false);
@@ -794,6 +796,7 @@ public class ApiClient {
           put("v2.muteFindings", false);
           put("v2.runThreatHuntingJob", false);
           put("v2.searchSecurityMonitoringHistsignals", false);
+          put("v2.updateInvestigationFeedback", false);
           put("v2.createDataset", false);
           put("v2.deleteDataset", false);
           put("v2.getAllDatasets", false);