Document monitor scope for investigations

.generator/schemas/v2/openapi.yaml

@@ -44920,6 +44920,9 @@ components:
           description: Name of the API key.
           example: "API Key for submitting metrics"
           type: string
+        private_action_runner_enroll_enabled:
+          description: Whether the API key can enroll a Private Action Runner.
+          type: boolean
         remote_config_read_enabled:
           description: The remote config read enabled status.
           type: boolean
@@ -84281,6 +84284,9 @@ components:
           description: Name of the API key.
           example: "API Key for submitting metrics"
           type: string
+        private_action_runner_enroll_enabled:
+          description: Whether the API key can enroll a Private Action Runner.
+          type: boolean
         remote_config_read_enabled:
           description: The remote config read enabled status.
           type: boolean
@@ -136793,7 +136799,9 @@ paths:
         **Note**: This endpoint is in preview and is subject to change.
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
     post:
-      description: Trigger a new Bits AI investigation based on a monitor alert.
+      description: |-
+        Trigger a new Bits AI investigation based on a monitor alert.
+        The `monitors_read` permission is required when the trigger type is `monitor_alert_trigger`.
       operationId: TriggerInvestigation
       requestBody:
         content:
@@ -136842,14 +136850,16 @@ paths:
           appKeyAuth: []
         - AuthZ:
             - bits_investigations_write
+            - monitors_read
       summary: Trigger a Bits AI investigation
       tags:
         - Bits AI
       x-codegen-request-body-name: body
       "x-permission":
-        operator: OR
+        operator: AND
         permissions:
           - bits_investigations_write
+          - monitors_read
       x-unstable: |-
         **Note**: This endpoint is in preview and is subject to change.
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).

src/main/java/com/datadog/api/client/v2/api/BitsAiApi.java

@@ -507,7 +507,8 @@ public CompletableFuture<TriggerInvestigationResponse> triggerInvestigationAsync
   }
 
   /**
-   * Trigger a new Bits AI investigation based on a monitor alert.
+   * Trigger a new Bits AI investigation based on a monitor alert. The <code>monitors_read</code>
+   * permission is required when the trigger type is <code>monitor_alert_trigger</code>.
    *
    * @param body Trigger investigation request body. (required)
    * @return ApiResponse&lt;TriggerInvestigationResponse&gt;

src/main/java/com/datadog/api/client/v2/model/FullAPIKeyAttributes.java

@@ -27,6 +27,7 @@
   FullAPIKeyAttributes.JSON_PROPERTY_LAST4,
   FullAPIKeyAttributes.JSON_PROPERTY_MODIFIED_AT,
   FullAPIKeyAttributes.JSON_PROPERTY_NAME,
+  FullAPIKeyAttributes.JSON_PROPERTY_PRIVATE_ACTION_RUNNER_ENROLL_ENABLED,
   FullAPIKeyAttributes.JSON_PROPERTY_REMOTE_CONFIG_READ_ENABLED
 })
 @jakarta.annotation.Generated(
@@ -54,6 +55,10 @@ public class FullAPIKeyAttributes {
   public static final String JSON_PROPERTY_NAME = "name";
   private String name;
 
+  public static final String JSON_PROPERTY_PRIVATE_ACTION_RUNNER_ENROLL_ENABLED =
+      "private_action_runner_enroll_enabled";
+  private Boolean privateActionRunnerEnrollEnabled;
+
   public static final String JSON_PROPERTY_REMOTE_CONFIG_READ_ENABLED =
       "remote_config_read_enabled";
   private Boolean remoteConfigReadEnabled;
@@ -174,6 +179,28 @@ public void setName(String name) {
     this.name = name;
   }
 
+  public FullAPIKeyAttributes privateActionRunnerEnrollEnabled(
+      Boolean privateActionRunnerEnrollEnabled) {
+    this.privateActionRunnerEnrollEnabled = privateActionRunnerEnrollEnabled;
+    return this;
+  }
+
+  /**
+   * Whether the API key can enroll a Private Action Runner.
+   *
+   * @return privateActionRunnerEnrollEnabled
+   */
+  @jakarta.annotation.Nullable
+  @JsonProperty(JSON_PROPERTY_PRIVATE_ACTION_RUNNER_ENROLL_ENABLED)
+  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  public Boolean getPrivateActionRunnerEnrollEnabled() {
+    return privateActionRunnerEnrollEnabled;
+  }
+
+  public void setPrivateActionRunnerEnrollEnabled(Boolean privateActionRunnerEnrollEnabled) {
+    this.privateActionRunnerEnrollEnabled = privateActionRunnerEnrollEnabled;
+  }
+
   public FullAPIKeyAttributes remoteConfigReadEnabled(Boolean remoteConfigReadEnabled) {
     this.remoteConfigReadEnabled = remoteConfigReadEnabled;
     return this;
@@ -258,6 +285,9 @@ public boolean equals(Object o) {
         && Objects.equals(this.last4, fullApiKeyAttributes.last4)
         && Objects.equals(this.modifiedAt, fullApiKeyAttributes.modifiedAt)
         && Objects.equals(this.name, fullApiKeyAttributes.name)
+        && Objects.equals(
+            this.privateActionRunnerEnrollEnabled,
+            fullApiKeyAttributes.privateActionRunnerEnrollEnabled)
         && Objects.equals(
             this.remoteConfigReadEnabled, fullApiKeyAttributes.remoteConfigReadEnabled)
         && Objects.equals(this.additionalProperties, fullApiKeyAttributes.additionalProperties);
@@ -273,6 +303,7 @@ public int hashCode() {
         last4,
         modifiedAt,
         name,
+        privateActionRunnerEnrollEnabled,
         remoteConfigReadEnabled,
         additionalProperties);
   }
@@ -288,6 +319,9 @@ public String toString() {
     sb.append("    last4: ").append(toIndentedString(last4)).append("\n");
     sb.append("    modifiedAt: ").append(toIndentedString(modifiedAt)).append("\n");
     sb.append("    name: ").append(toIndentedString(name)).append("\n");
+    sb.append("    privateActionRunnerEnrollEnabled: ")
+        .append(toIndentedString(privateActionRunnerEnrollEnabled))
+        .append("\n");
     sb.append("    remoteConfigReadEnabled: ")
         .append(toIndentedString(remoteConfigReadEnabled))
         .append("\n");

src/main/java/com/datadog/api/client/v2/model/PartialAPIKeyAttributes.java

@@ -26,6 +26,7 @@
   PartialAPIKeyAttributes.JSON_PROPERTY_LAST4,
   PartialAPIKeyAttributes.JSON_PROPERTY_MODIFIED_AT,
   PartialAPIKeyAttributes.JSON_PROPERTY_NAME,
+  PartialAPIKeyAttributes.JSON_PROPERTY_PRIVATE_ACTION_RUNNER_ENROLL_ENABLED,
   PartialAPIKeyAttributes.JSON_PROPERTY_REMOTE_CONFIG_READ_ENABLED
 })
 @jakarta.annotation.Generated(
@@ -50,6 +51,10 @@ public class PartialAPIKeyAttributes {
   public static final String JSON_PROPERTY_NAME = "name";
   private String name;
 
+  public static final String JSON_PROPERTY_PRIVATE_ACTION_RUNNER_ENROLL_ENABLED =
+      "private_action_runner_enroll_enabled";
+  private Boolean privateActionRunnerEnrollEnabled;
+
   public static final String JSON_PROPERTY_REMOTE_CONFIG_READ_ENABLED =
       "remote_config_read_enabled";
   private Boolean remoteConfigReadEnabled;
@@ -158,6 +163,28 @@ public void setName(String name) {
     this.name = name;
   }
 
+  public PartialAPIKeyAttributes privateActionRunnerEnrollEnabled(
+      Boolean privateActionRunnerEnrollEnabled) {
+    this.privateActionRunnerEnrollEnabled = privateActionRunnerEnrollEnabled;
+    return this;
+  }
+
+  /**
+   * Whether the API key can enroll a Private Action Runner.
+   *
+   * @return privateActionRunnerEnrollEnabled
+   */
+  @jakarta.annotation.Nullable
+  @JsonProperty(JSON_PROPERTY_PRIVATE_ACTION_RUNNER_ENROLL_ENABLED)
+  @JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
+  public Boolean getPrivateActionRunnerEnrollEnabled() {
+    return privateActionRunnerEnrollEnabled;
+  }
+
+  public void setPrivateActionRunnerEnrollEnabled(Boolean privateActionRunnerEnrollEnabled) {
+    this.privateActionRunnerEnrollEnabled = privateActionRunnerEnrollEnabled;
+  }
+
   public PartialAPIKeyAttributes remoteConfigReadEnabled(Boolean remoteConfigReadEnabled) {
     this.remoteConfigReadEnabled = remoteConfigReadEnabled;
     return this;
@@ -241,6 +268,9 @@ public boolean equals(Object o) {
         && Objects.equals(this.last4, partialApiKeyAttributes.last4)
         && Objects.equals(this.modifiedAt, partialApiKeyAttributes.modifiedAt)
         && Objects.equals(this.name, partialApiKeyAttributes.name)
+        && Objects.equals(
+            this.privateActionRunnerEnrollEnabled,
+            partialApiKeyAttributes.privateActionRunnerEnrollEnabled)
         && Objects.equals(
             this.remoteConfigReadEnabled, partialApiKeyAttributes.remoteConfigReadEnabled)
         && Objects.equals(this.additionalProperties, partialApiKeyAttributes.additionalProperties);
@@ -255,6 +285,7 @@ public int hashCode() {
         last4,
         modifiedAt,
         name,
+        privateActionRunnerEnrollEnabled,
         remoteConfigReadEnabled,
         additionalProperties);
   }
@@ -269,6 +300,9 @@ public String toString() {
     sb.append("    last4: ").append(toIndentedString(last4)).append("\n");
     sb.append("    modifiedAt: ").append(toIndentedString(modifiedAt)).append("\n");
     sb.append("    name: ").append(toIndentedString(name)).append("\n");
+    sb.append("    privateActionRunnerEnrollEnabled: ")
+        .append(toIndentedString(privateActionRunnerEnrollEnabled))
+        .append("\n");
     sb.append("    remoteConfigReadEnabled: ")
         .append(toIndentedString(remoteConfigReadEnabled))
         .append("\n");