Notification rule conditionals

.generator/schemas/v2/openapi.yaml

@@ -36811,7 +36811,10 @@ components:
       - name
       type: object
     MonitorNotificationRuleCondition:
-      description: Conditions for `conditional_recipients`.
+      description: 'A conditional recipient rule composed of a `scope` (the matching
+        condition) and
+
+        `recipients` (who to notify when it matches).'
       properties:
         recipients:
           $ref: '#/components/schemas/MonitorNotificationRuleRecipients'
@@ -36824,8 +36827,13 @@ components:
       - recipients
       type: object
     MonitorNotificationRuleConditionScope:
-      description: The scope to which the monitor applied.
-      example: transition_type:alert
+      description: 'Defines the condition under which the recipients are notified.
+        Supported formats:
+
+        - Monitor status condition using `transition_type:<status>`, for example `transition_type:is_alert`.
+
+        - A single tag key:value pair, for example `env:prod`.'
+      example: transition_type:is_alert
       maxLength: 3000
       minLength: 1
       type: string
@@ -36878,18 +36886,18 @@ components:
           $ref: '#/components/schemas/MonitorNotificationRuleResourceType'
       type: object
     MonitorNotificationRuleFilter:
-      description: Filter used to associate the notification rule with monitors.
+      description: Specifies the matching criteria for monitor notifications.
       oneOf:
       - $ref: '#/components/schemas/MonitorNotificationRuleFilterTags'
       - $ref: '#/components/schemas/MonitorNotificationRuleFilterScope'
     MonitorNotificationRuleFilterScope:
       additionalProperties: false
-      description: Filter monitor notifications. A monitor notification must match
-        the scope.
+      description: Filters monitor notifications using a scope expression over key:value
+        pairs with boolean logic (AND, OR, NOT).
       properties:
         scope:
-          description: A scope composed of one or several key:value pairs, which can
-            be used to filter monitor notifications on monitor and group tags.
+          description: A scope expression composed by key:value pairs (e.g. `service:foo`)
+            with boolean operators (AND, OR, NOT) and parentheses for grouping.
           example: service:(foo OR bar) AND team:test NOT environment:staging
           maxLength: 3000
           minLength: 1
@@ -36899,12 +36907,11 @@ components:
       type: object
     MonitorNotificationRuleFilterTags:
       additionalProperties: false
-      description: Filter monitor notifications by tags. A monitor notification must
-        match all tags.
+      description: Filters monitor notifications by a list of tag key:value pairs.
       properties:
         tags:
-          description: A list of tags (key:value pairs), which can be used to filter
-            monitor notifications on monitor and group tags.
+          description: A list of tag key:value pairs (e.g. `team:product`). All tags
+            must match (AND semantics).
           example:
           - team:product
           - host:abc

services/monitors/src/v2/models/MonitorNotificationRuleAttributes.ts

@@ -12,7 +12,7 @@ export class MonitorNotificationRuleAttributes {
    */
   "conditionalRecipients"?: MonitorNotificationRuleConditionalRecipients;
   /**
-   * Filter used to associate the notification rule with monitors.
+   * Specifies the matching criteria for monitor notifications.
    */
   "filter"?: MonitorNotificationRuleFilter;
   /**

services/monitors/src/v2/models/MonitorNotificationRuleCondition.ts

@@ -1,15 +1,18 @@
 import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
 /**
- * Conditions for `conditional_recipients`.
+ * A conditional recipient rule composed of a `scope` (the matching condition) and
+ * `recipients` (who to notify when it matches).
  */
 export class MonitorNotificationRuleCondition {
   /**
    * A list of recipients to notify. Uses the same format as the monitor `message` field. Must not start with an '@'. Cannot be used with `conditional_recipients`.
    */
   "recipients": Array<string>;
   /**
-   * The scope to which the monitor applied.
+   * Defines the condition under which the recipients are notified. Supported formats:
+   * - Monitor status condition using `transition_type:<status>`, for example `transition_type:is_alert`.
+   * - A single tag key:value pair, for example `env:prod`.
    */
   "scope": string;
   /**

services/monitors/src/v2/models/MonitorNotificationRuleFilter.ts

@@ -4,7 +4,7 @@ import { MonitorNotificationRuleFilterScope } from "./MonitorNotificationRuleFil
 import { MonitorNotificationRuleFilterTags } from "./MonitorNotificationRuleFilterTags";
 
 /**
- * Filter used to associate the notification rule with monitors.
+ * Specifies the matching criteria for monitor notifications.
  */
 export type MonitorNotificationRuleFilter =
   | MonitorNotificationRuleFilterTags

services/monitors/src/v2/models/MonitorNotificationRuleFilterScope.ts

@@ -1,11 +1,11 @@
 import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
 /**
- * Filter monitor notifications. A monitor notification must match the scope.
+ * Filters monitor notifications using a scope expression over key:value pairs with boolean logic (AND, OR, NOT).
  */
 export class MonitorNotificationRuleFilterScope {
   /**
-   * A scope composed of one or several key:value pairs, which can be used to filter monitor notifications on monitor and group tags.
+   * A scope expression composed by key:value pairs (e.g. `service:foo`) with boolean operators (AND, OR, NOT) and parentheses for grouping.
    */
   "scope": string;
   /**

services/monitors/src/v2/models/MonitorNotificationRuleFilterTags.ts

@@ -1,11 +1,11 @@
 import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
 /**
- * Filter monitor notifications by tags. A monitor notification must match all tags.
+ * Filters monitor notifications by a list of tag key:value pairs.
  */
 export class MonitorNotificationRuleFilterTags {
   /**
-   * A list of tags (key:value pairs), which can be used to filter monitor notifications on monitor and group tags.
+   * A list of tag key:value pairs (e.g. `team:product`). All tags must match (AND semantics).
    */
   "tags": Array<string>;
   /**

services/monitors/src/v2/models/MonitorNotificationRuleResponseAttributes.ts

@@ -16,7 +16,7 @@ export class MonitorNotificationRuleResponseAttributes {
    */
   "created"?: Date;
   /**
-   * Filter used to associate the notification rule with monitors.
+   * Specifies the matching criteria for monitor notifications.
    */
   "filter"?: MonitorNotificationRuleFilter;
   /**