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/).

packages/datadog-api-client-v2/apis/BitsAIApi.ts

@@ -570,6 +570,7 @@ export class BitsAIApi {
 
   /**
    * 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`.
    * @param param The request object
    */
   public triggerInvestigation(

packages/datadog-api-client-v2/models/FullAPIKeyAttributes.ts

@@ -38,6 +38,10 @@ export class FullAPIKeyAttributes {
    * Name of the API key.
    */
   "name"?: string;
+  /**
+   * Whether the API key can enroll a Private Action Runner.
+   */
+  "privateActionRunnerEnrollEnabled"?: boolean;
   /**
    * The remote config read enabled status.
    */
@@ -90,6 +94,10 @@ export class FullAPIKeyAttributes {
       baseName: "name",
       type: "string",
     },
+    privateActionRunnerEnrollEnabled: {
+      baseName: "private_action_runner_enroll_enabled",
+      type: "boolean",
+    },
     remoteConfigReadEnabled: {
       baseName: "remote_config_read_enabled",
       type: "boolean",

packages/datadog-api-client-v2/models/PartialAPIKeyAttributes.ts

@@ -34,6 +34,10 @@ export class PartialAPIKeyAttributes {
    * Name of the API key.
    */
   "name"?: string;
+  /**
+   * Whether the API key can enroll a Private Action Runner.
+   */
+  "privateActionRunnerEnrollEnabled"?: boolean;
   /**
    * The remote config read enabled status.
    */
@@ -80,6 +84,10 @@ export class PartialAPIKeyAttributes {
       baseName: "name",
       type: "string",
     },
+    privateActionRunnerEnrollEnabled: {
+      baseName: "private_action_runner_enroll_enabled",
+      type: "boolean",
+    },
     remoteConfigReadEnabled: {
       baseName: "remote_config_read_enabled",
       type: "boolean",