@@ -21204,6 +21204,164 @@ components:
2120421204 type:
2120521205 $ref: '#/components/schemas/MonitorDowntimeMatchResourceType'
2120621206 type: object
21207+ MonitorNotificationRuleAttributes:
21208+ additionalProperties: false
21209+ description: Attributes of the monitor notification rule.
21210+ properties:
21211+ filter:
21212+ $ref: '#/components/schemas/MonitorNotificationRuleFilter'
21213+ name:
21214+ $ref: '#/components/schemas/MonitorNotificationRuleName'
21215+ recipients:
21216+ $ref: '#/components/schemas/MonitorNotificationRuleRecipients'
21217+ required:
21218+ - name
21219+ - recipients
21220+ type: object
21221+ MonitorNotificationRuleCreateRequest:
21222+ description: Request for creating a monitor notification rule.
21223+ properties:
21224+ data:
21225+ $ref: '#/components/schemas/MonitorNotificationRuleCreateRequestData'
21226+ required:
21227+ - data
21228+ type: object
21229+ MonitorNotificationRuleCreateRequestData:
21230+ description: Object to create a monitor notification rule.
21231+ properties:
21232+ attributes:
21233+ $ref: '#/components/schemas/MonitorNotificationRuleAttributes'
21234+ type:
21235+ $ref: '#/components/schemas/MonitorNotificationRuleResourceType'
21236+ required:
21237+ - attributes
21238+ type: object
21239+ MonitorNotificationRuleData:
21240+ description: Monitor notification rule data.
21241+ properties:
21242+ attributes:
21243+ $ref: '#/components/schemas/MonitorNotificationRuleResponseAttributes'
21244+ id:
21245+ $ref: '#/components/schemas/MonitorNotificationRuleId'
21246+ type:
21247+ $ref: '#/components/schemas/MonitorNotificationRuleResourceType'
21248+ type: object
21249+ MonitorNotificationRuleFilter:
21250+ description: Filter used to associate the notification rule with monitors.
21251+ oneOf:
21252+ - $ref: '#/components/schemas/MonitorNotificationRuleFilterTags'
21253+ MonitorNotificationRuleFilterTags:
21254+ additionalProperties: false
21255+ description: Filter monitors by tags. Monitors must match all tags.
21256+ properties:
21257+ tags:
21258+ description: The `MonitorNotificationRuleFilterTags` `tags`.
21259+ example:
21260+ - team:product
21261+ - host:abc
21262+ items:
21263+ maxLength: 255
21264+ type: string
21265+ maxItems: 20
21266+ minItems: 1
21267+ type: array
21268+ uniqueItems: true
21269+ required:
21270+ - tags
21271+ type: object
21272+ MonitorNotificationRuleId:
21273+ description: The ID of the monitor notification rule.
21274+ example: 00000000-0000-1234-0000-000000000000
21275+ type: string
21276+ MonitorNotificationRuleListResponse:
21277+ description: Response for retrieving all monitor notification rules.
21278+ properties:
21279+ data:
21280+ description: A list of monitor notification rules.
21281+ items:
21282+ $ref: '#/components/schemas/MonitorNotificationRuleData'
21283+ type: array
21284+ type: object
21285+ MonitorNotificationRuleName:
21286+ description: The name of the monitor notification rule.
21287+ example: A notification rule name
21288+ maxLength: 1000
21289+ minLength: 1
21290+ type: string
21291+ MonitorNotificationRuleRecipients:
21292+ description: A list of recipients to notify. Uses the same format as the monitor
21293+ `message` field. Must not start with an '@'.
21294+ example:
21295+ - slack-test-channel
21296+ - jira-test
21297+ items:
21298+ description: individual recipient.
21299+ maxLength: 255
21300+ type: string
21301+ maxItems: 20
21302+ minItems: 1
21303+ type: array
21304+ uniqueItems: true
21305+ MonitorNotificationRuleResourceType:
21306+ default: monitor-notification-rule
21307+ description: Monitor notification rule resource type.
21308+ enum:
21309+ - monitor-notification-rule
21310+ example: monitor-notification-rule
21311+ type: string
21312+ x-enum-varnames:
21313+ - MONITOR_NOTIFICATION_RULE
21314+ MonitorNotificationRuleResponse:
21315+ description: A monitor notification rule.
21316+ properties:
21317+ data:
21318+ $ref: '#/components/schemas/MonitorNotificationRuleData'
21319+ type: object
21320+ MonitorNotificationRuleResponseAttributes:
21321+ description: Attributes of the monitor notification rule.
21322+ properties:
21323+ created_at:
21324+ description: Creation time of the monitor notification rule.
21325+ example: 2020-01-02 03:04:00+00:00
21326+ format: date-time
21327+ type: string
21328+ creator_uuid:
21329+ description: ID of the user who created the monitor notification rule.
21330+ example: 00000000-0000-1234-0000-000000000000
21331+ type: string
21332+ filter:
21333+ $ref: '#/components/schemas/MonitorNotificationRuleFilter'
21334+ modified_at:
21335+ description: Time the monitor notification rule was last modified.
21336+ example: 2020-01-02 03:04:00+00:00
21337+ format: date-time
21338+ type: string
21339+ name:
21340+ $ref: '#/components/schemas/MonitorNotificationRuleName'
21341+ recipients:
21342+ $ref: '#/components/schemas/MonitorNotificationRuleRecipients'
21343+ type: object
21344+ MonitorNotificationRuleUpdateRequest:
21345+ description: Request for updating a monitor notification rule.
21346+ properties:
21347+ data:
21348+ $ref: '#/components/schemas/MonitorNotificationRuleUpdateRequestData'
21349+ required:
21350+ - data
21351+ type: object
21352+ MonitorNotificationRuleUpdateRequestData:
21353+ description: Object to update a monitor notification rule.
21354+ properties:
21355+ attributes:
21356+ $ref: '#/components/schemas/MonitorNotificationRuleAttributes'
21357+ id:
21358+ $ref: '#/components/schemas/MonitorNotificationRuleId'
21359+ type:
21360+ $ref: '#/components/schemas/MonitorNotificationRuleResourceType'
21361+ required:
21362+ - id
21363+ - attributes
21364+ type: object
2120721365 MonitorTrigger:
2120821366 description: Trigger a workflow from a Monitor. For automatic triggering a handle
2120921367 must be configured and the workflow must be published.
@@ -34079,6 +34237,7 @@ components:
3407934237 incident_settings_write: Configure Incident Settings.
3408034238 incident_write: Create, view, and manage incidents in Datadog.
3408134239 metrics_read: View custom metrics.
34240+ monitor_config_policy_write: Edit and delete monitor configuration.
3408234241 monitors_downtime: Set downtimes to suppress alerts from any monitor in
3408334242 an organization. Mute and unmute monitors. The ability to write monitors
3408434243 is not required to set downtimes.
@@ -43994,6 +44153,190 @@ paths:
4399444153 x-permission:
4399544154 operator: OPEN
4399644155 permissions: []
44156+ /api/v2/monitor/notification_rule:
44157+ get:
44158+ description: Returns a list of all monitor notification rules.
44159+ operationId: GetMonitorNotificationRules
44160+ responses:
44161+ '200':
44162+ content:
44163+ application/json:
44164+ schema:
44165+ $ref: '#/components/schemas/MonitorNotificationRuleListResponse'
44166+ description: OK
44167+ '429':
44168+ $ref: '#/components/responses/TooManyRequestsResponse'
44169+ security:
44170+ - apiKeyAuth: []
44171+ appKeyAuth: []
44172+ - AuthZ:
44173+ - monitors_read
44174+ summary: Get all monitor notification rules
44175+ tags:
44176+ - Monitor Notification Rules
44177+ x-permission:
44178+ operator: OR
44179+ permissions:
44180+ - monitors_read
44181+ post:
44182+ description: Creates a monitor notification rule.
44183+ operationId: CreateMonitorNotificationRule
44184+ requestBody:
44185+ content:
44186+ application/json:
44187+ schema:
44188+ $ref: '#/components/schemas/MonitorNotificationRuleCreateRequest'
44189+ description: Request body to create a monitor notification rule.
44190+ required: true
44191+ responses:
44192+ '200':
44193+ content:
44194+ application/json:
44195+ schema:
44196+ $ref: '#/components/schemas/MonitorNotificationRuleResponse'
44197+ description: OK
44198+ '400':
44199+ content:
44200+ application/json:
44201+ schema:
44202+ $ref: '#/components/schemas/APIErrorResponse'
44203+ description: Bad Request
44204+ '429':
44205+ $ref: '#/components/responses/TooManyRequestsResponse'
44206+ security:
44207+ - apiKeyAuth: []
44208+ appKeyAuth: []
44209+ - AuthZ:
44210+ - monitor_config_policy_write
44211+ summary: Create a monitor notification rule
44212+ tags:
44213+ - Monitor Notification Rules
44214+ x-permission:
44215+ operator: OR
44216+ permissions:
44217+ - monitor_config_policy_write
44218+ /api/v2/monitor/notification_rule/{rule_id}:
44219+ delete:
44220+ description: Deletes a monitor notification rule by `rule_id`.
44221+ operationId: DeleteMonitorNotificationRule
44222+ parameters:
44223+ - description: ID of the monitor notification rule to delete.
44224+ in: path
44225+ name: rule_id
44226+ required: true
44227+ schema:
44228+ type: string
44229+ responses:
44230+ '204':
44231+ description: OK
44232+ '404':
44233+ content:
44234+ application/json:
44235+ schema:
44236+ $ref: '#/components/schemas/APIErrorResponse'
44237+ description: Not Found
44238+ '429':
44239+ $ref: '#/components/responses/TooManyRequestsResponse'
44240+ security:
44241+ - apiKeyAuth: []
44242+ appKeyAuth: []
44243+ - AuthZ:
44244+ - monitor_config_policy_write
44245+ summary: Delete a monitor notification rule
44246+ tags:
44247+ - Monitor Notification Rules
44248+ x-permission:
44249+ operator: OR
44250+ permissions:
44251+ - monitor_config_policy_write
44252+ get:
44253+ description: Returns a monitor notification rule by `rule_id`.
44254+ operationId: GetMonitorNotificationRule
44255+ parameters:
44256+ - description: ID of the monitor notification rule to fetch.
44257+ in: path
44258+ name: rule_id
44259+ required: true
44260+ schema:
44261+ type: string
44262+ responses:
44263+ '200':
44264+ content:
44265+ application/json:
44266+ schema:
44267+ $ref: '#/components/schemas/MonitorNotificationRuleResponse'
44268+ description: OK
44269+ '404':
44270+ content:
44271+ application/json:
44272+ schema:
44273+ $ref: '#/components/schemas/APIErrorResponse'
44274+ description: Not Found
44275+ '429':
44276+ $ref: '#/components/responses/TooManyRequestsResponse'
44277+ security:
44278+ - apiKeyAuth: []
44279+ appKeyAuth: []
44280+ - AuthZ:
44281+ - monitors_read
44282+ summary: Get a monitor notification rule
44283+ tags:
44284+ - Monitor Notification Rules
44285+ x-permission:
44286+ operator: OR
44287+ permissions:
44288+ - monitors_read
44289+ patch:
44290+ description: Updates a monitor notification rule by `rule_id`.
44291+ operationId: UpdateMonitorNotificationRule
44292+ parameters:
44293+ - description: ID of the monitor notification rule to update.
44294+ in: path
44295+ name: rule_id
44296+ required: true
44297+ schema:
44298+ type: string
44299+ requestBody:
44300+ content:
44301+ application/json:
44302+ schema:
44303+ $ref: '#/components/schemas/MonitorNotificationRuleUpdateRequest'
44304+ description: Request body to update the monitor notification rule.
44305+ required: true
44306+ responses:
44307+ '200':
44308+ content:
44309+ application/json:
44310+ schema:
44311+ $ref: '#/components/schemas/MonitorNotificationRuleResponse'
44312+ description: OK
44313+ '400':
44314+ content:
44315+ application/json:
44316+ schema:
44317+ $ref: '#/components/schemas/APIErrorResponse'
44318+ description: Bad Request
44319+ '404':
44320+ content:
44321+ application/json:
44322+ schema:
44323+ $ref: '#/components/schemas/APIErrorResponse'
44324+ description: Not Found
44325+ '429':
44326+ $ref: '#/components/responses/TooManyRequestsResponse'
44327+ security:
44328+ - apiKeyAuth: []
44329+ appKeyAuth: []
44330+ - AuthZ:
44331+ - monitor_config_policy_write
44332+ summary: Update a monitor notification rule
44333+ tags:
44334+ - Monitor Notification Rules
44335+ x-codegen-request-body-name: body
44336+ x-permission:
44337+ operator: OR
44338+ permissions:
44339+ - monitor_config_policy_write
4399744340 /api/v2/monitor/policy:
4399844341 get:
4399944342 description: Get all monitor configuration policies.
@@ -53989,6 +54332,11 @@ tags:
5398954332 see the integration page.
5399054333 url: https://docs.datadoghq.com/integrations/microsoft_teams/
5399154334 name: Microsoft Teams Integration
54335+ - description: 'Monitor Notification Rules allow users to define recipient routing
54336+ behavior for monitor alerts
54337+
54338+ based on monitor metadata such as tags.'
54339+ name: Monitor Notification Rules
5399254340- description: '[Monitors](https://docs.datadoghq.com/monitors) allow you to watch
5399354341 a metric or check that you care about and
5399454342
0 commit comments