@@ -46574,6 +46574,81 @@ components:
4657446574 required:
4657546575 - type
4657646576 type: object
46577+ GeneralInvestigationAttributes:
46578+ description: Attributes for a general investigation, not tied to a specific monitor alert.
46579+ oneOf:
46580+ - $ref: "#/components/schemas/GeneralInvestigationAttributesWithoutTimeBounds"
46581+ - $ref: "#/components/schemas/GeneralInvestigationAttributesWithTimeBounds"
46582+ GeneralInvestigationAttributesWithTimeBounds:
46583+ additionalProperties: false
46584+ description: Attributes for a general investigation with an explicit time window.
46585+ properties:
46586+ description:
46587+ description: A free-form description of what to investigate, up to 4,096 characters.
46588+ example: "Checkout latency has been elevated for the past hour."
46589+ maxLength: 4096
46590+ type: string
46591+ end_time:
46592+ description: The end of the investigation window, in Unix milliseconds.
46593+ example: 1700003600000
46594+ format: int64
46595+ type: integer
46596+ start_time:
46597+ description: The start of the investigation window, in Unix milliseconds.
46598+ example: 1700000000000
46599+ format: int64
46600+ type: integer
46601+ tags:
46602+ description: Tags that scope the investigation.
46603+ example:
46604+ - "service:checkout"
46605+ items:
46606+ type: string
46607+ type: array
46608+ required:
46609+ - description
46610+ - start_time
46611+ - end_time
46612+ type: object
46613+ GeneralInvestigationAttributesWithoutTimeBounds:
46614+ additionalProperties: false
46615+ description: Attributes for a general investigation without an explicit time window.
46616+ properties:
46617+ description:
46618+ description: A free-form description of what to investigate, up to 4,096 characters.
46619+ example: "Checkout latency has been elevated for the past hour."
46620+ maxLength: 4096
46621+ type: string
46622+ tags:
46623+ description: Tags that scope the investigation.
46624+ example:
46625+ - "service:checkout"
46626+ items:
46627+ type: string
46628+ type: array
46629+ required:
46630+ - description
46631+ type: object
46632+ GeneralInvestigationTrigger:
46633+ additionalProperties: false
46634+ description: A trigger created from a general investigation request.
46635+ properties:
46636+ general_investigation:
46637+ $ref: "#/components/schemas/GeneralInvestigationAttributes"
46638+ type:
46639+ $ref: "#/components/schemas/GeneralInvestigationTriggerType"
46640+ required:
46641+ - type
46642+ - general_investigation
46643+ type: object
46644+ GeneralInvestigationTriggerType:
46645+ description: The type of general investigation trigger.
46646+ enum:
46647+ - general_investigation
46648+ example: general_investigation
46649+ type: string
46650+ x-enum-varnames:
46651+ - GENERAL_INVESTIGATION
4657746652 GenerateCostTagDescriptionResponse:
4657846653 description: Response wrapping an AI-generated Cloud Cost Management tag key description.
4657946654 example:
@@ -72350,6 +72425,18 @@ components:
7235072425 - key
7235172426 - value
7235272427 type: object
72428+ MonitorAlertTrigger:
72429+ additionalProperties: false
72430+ description: A trigger created from a monitor alert.
72431+ properties:
72432+ monitor_alert_trigger:
72433+ $ref: "#/components/schemas/MonitorAlertTriggerAttributes"
72434+ type:
72435+ $ref: "#/components/schemas/MonitorAlertTriggerType"
72436+ required:
72437+ - type
72438+ - monitor_alert_trigger
72439+ type: object
7235372440 MonitorAlertTriggerAttributes:
7235472441 description: Attributes for a monitor alert trigger.
7235572442 properties:
@@ -72372,6 +72459,14 @@ components:
7237272459 - event_id
7237372460 - event_ts
7237472461 type: object
72462+ MonitorAlertTriggerType:
72463+ description: The type of monitor alert trigger.
72464+ enum:
72465+ - monitor_alert_trigger
72466+ example: monitor_alert_trigger
72467+ type: string
72468+ x-enum-varnames:
72469+ - MONITOR_ALERT_TRIGGER
7237572470 MonitorConfigPolicyAttributeCreateRequest:
7237672471 description: Policy and policy type for a monitor configuration policy.
7237772472 properties:
@@ -124722,15 +124817,23 @@ components:
124722124817 - $ref: "#/components/schemas/SoftwareCatalogTriggerWrapper"
124723124818 - $ref: "#/components/schemas/WorkflowTriggerWrapper"
124724124819 TriggerAttributes:
124820+ anyOf:
124821+ - $ref: "#/components/schemas/MonitorAlertTrigger"
124822+ - $ref: "#/components/schemas/GeneralInvestigationTrigger"
124725124823 description: The trigger definition for starting an investigation.
124824+ example:
124825+ monitor_alert_trigger:
124826+ event_id: "1234567890123456789"
124827+ event_ts: 1700000000000
124828+ monitor_id: 12345678
124829+ type: monitor_alert_trigger
124726124830 properties:
124831+ general_investigation:
124832+ $ref: "#/components/schemas/GeneralInvestigationAttributes"
124727124833 monitor_alert_trigger:
124728124834 $ref: "#/components/schemas/MonitorAlertTriggerAttributes"
124729124835 type:
124730124836 $ref: "#/components/schemas/TriggerType"
124731- required:
124732- - type
124733- - monitor_alert_trigger
124734124837 type: object
124735124838 TriggerInvestigationRequest:
124736124839 description: Request to trigger a new investigation.
@@ -124836,10 +124939,12 @@ components:
124836124939 description: The type of trigger for the investigation.
124837124940 enum:
124838124941 - monitor_alert_trigger
124942+ - general_investigation
124839124943 example: monitor_alert_trigger
124840124944 type: string
124841124945 x-enum-varnames:
124842124946 - MONITOR_ALERT_TRIGGER
124947+ - GENERAL_INVESTIGATION
124843124948 TriggerWorkflowAutomationAction:
124844124949 description: "Triggers a Workflow Automation."
124845124950 properties:
@@ -137627,7 +137732,7 @@ paths:
137627137732 If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
137628137733 post:
137629137734 description: |-
137630- Trigger a new Bits AI investigation based on a monitor alert.
137735+ Trigger a Bits AI investigation from a monitor alert or a general investigation .
137631137736 The `monitors_read` permission is required when the trigger type is `monitor_alert_trigger`.
137632137737 operationId: TriggerInvestigation
137633137738 requestBody:
@@ -137645,6 +137750,17 @@ paths:
137645137750 monitor_id: 12345678
137646137751 type: monitor_alert_trigger
137647137752 type: trigger_investigation_request
137753+ general_investigation:
137754+ value:
137755+ data:
137756+ attributes:
137757+ trigger:
137758+ general_investigation:
137759+ description: "Checkout latency has been elevated for the past hour."
137760+ tags:
137761+ - "service:checkout"
137762+ type: general_investigation
137763+ type: trigger_investigation_request
137648137764 schema:
137649137765 $ref: "#/components/schemas/TriggerInvestigationRequest"
137650137766 description: Trigger investigation request body.
0 commit comments