Dependency-Track unofficial
PUT/v1/notification/rule/scheduled

Create a scheduled notification rule

Creates a new scheduled notification rule. Supply level, name, publisher, and scope, with the publisher identified by its UUID; name must contain 1 to 255 characters matching the allowed character pattern. You need SYSTEM_CONFIGURATION or SYSTEM_CONFIGURATION_CREATE permission.

4 body fields

Scheduled notification rule details to create. level, name, publisher, and scope are required.

levelstringrequired
Notification severity: `INFORMATIONAL`, `WARNING`, or `ERROR`.
Allowed:INFORMATIONALWARNINGERROR
namestringrequired
The notification rule name. Must be 1 to 255 characters containing whitespace, letters, marks, symbols, numbers, or punctuation.
publisherobjectrequired
The notification publisher to use. Supply its UUID in the required `uuid` field.
scopestringrequired
The rule scope: `SYSTEM` or `PORTFOLIO`.
Allowed:SYSTEMPORTFOLIO

3 status codes
201Returns the created scheduled notification rule, including its UUID, name, scope, trigger type, publisher, and scheduling details.
enabledbooleanoptional
filterExpressionstringoptional
logSuccessfulPublishbooleanoptional
messagestringoptional
namestringrequired
notificationLevelstringoptional
Allowed:INFORMATIONALWARNINGERROR
notifyChildrenbooleanoptional
notifyOnarray<string>optional
projectsarray<object>optional
publisherobjectoptional
publisherConfigstringoptional
scheduleCronstringoptional
Schedule of this rule as cron expression. Must not be set for rules with trigger type EVENT.
scheduleLastTriggeredAtintegeroptional
When the schedule last triggered, as UNIX epoch timestamp in milliseconds
scheduleNextTriggerAtintegeroptional
When the schedule triggers next, as UNIX epoch timestamp in milliseconds
scheduleSkipUnchangedbooleanoptional
Whether to skip emitting a scheduled notification if it doesn't contain any changes since its last emission. Must not be set for rules with trigger type EVENT.
scopestringrequired
Allowed:SYSTEMPORTFOLIO
tagsarray<object>optional
teamsarray<object>optional
triggerTypestringrequired
Allowed:EVENTSCHEDULE
uuidstringrequired
401Returned when the request is unauthorized.
404Returned when the UUID of the notification publisher cannot be found.

Error handling

A 401 is returned when the request is unauthorized, and a 404 is returned when the publisher identified by publisher.uuid cannot be found. level must be INFORMATIONAL, scope must be SYSTEM or PORTFOLIO, and name must be 1 to 255 characters containing whitespace, letters, marks, symbols, numbers, or punctuation.