Settings API - Vulnerability alerting profiles schema table

Vulnerability alerting profiles (builtin:appsec.notification-alerting-profile)

Vulnerability alerting profiles enable you to set up alert-filtering rules that are based on the risk level of detected vulnerabilities. This allows you to control which conditions result in security notifications and which don't.

Schema IDSchema groupsScope
builtin:appsec.notification-alerting-profile
  • group:alerting.appsec
  • group:alerting
environment
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:appsec.notification-alerting-profile
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:appsec.notification-alerting-profile
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:appsec.notification-alerting-profile

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

PropertyTypeDescriptionRequired
Enabled
enabled
boolean-required
Name
name
text-required
Alert for the following events:
enabledTriggerEvents
Set<TriggerEvent>
  • SECURITY_PROBLEM_OPENED
  • NEW_MANAGEMENT_ZONE_AFFECTED
required
Alert only if the following management zone is affected (optional)
managementZone
setting-optional
Risk Levels
enabledRiskLevels
Set<RiskLevel>
  • CRITICAL
  • HIGH
  • MEDIUM
  • LOW
required