Update an event notification in Dynatrace with the Notification Service API by its UUID, including title, resource, type, trigger configuration, input, and app.
| PUT | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/notification/v2/event-notifications/{id} |
You pass the event notification UUID in the id path parameter and send the updated title, resourceId, notificationType, triggerConfiguration, input, and appId in the request body. The response returns the updated event notification.
To execute this request, you need a platform token or OAuth access token with notification:notifications:write scope. To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| id | string | A UUID string identifying this self notification. | path | Required |
| body | Event | - | body | Required |
EventNotificationUpdate object| Element | Type | Description | Required |
|---|---|---|---|
| title | string | - | Optional |
| resourceId | string | Unique identifier of resource to notify on. Used to determine if there is a notification registered for a resource in context of the app and notification type for a user. | Optional |
| notificationType | string | String that defines the type of a notification in context of an app. Allows to differentiate between multiple types of notifications in context of one app. | Optional |
| triggerConfiguration | Event | - | Optional |
| input | Event | Input object consisting of subject and content. Supports automation expressions https://dt-url.net/workflows-expression-reference and markdown syntax. A template provided with an app ({notification_type}.notification-template.json) will take precedence over the input provided here. | Optional |
| appId | string | App id for registered notification. Optional, by default automatically inferred from the request. Only relevant for manual testing purposes via swagger. | Optional |
EventTriggerConfig objectEventQueryTriggerConfig objectConfig for generic event triggers ("Event trigger"). No dedup — fires on every matching event.
| Element | Type | Description | Required |
|---|---|---|---|
| type | Event | -The element can hold these values
| Required |
| value | Event | - | Required |
DavisProblemTriggerConfig objectConfig for Problem event triggers ("Problem trigger").
Deduplicated across a problem's lifecycle: fires once per phase selected by the trigger config (triggerOn, triggerOnUpdateFields), not on every update.
| Element | Type | Description | Required |
|---|---|---|---|
| type | Davis | -The element can hold these values
| Required |
| value | Davis | - | Required |
DavisEventTriggerConfig objectConfig for Davis Event event triggers ("Davis event trigger").
Deduplicated across an event's lifecycle: fires once per phase selected by the trigger config (triggerOn), not on every update.
| Element | Type | Description | Required |
|---|---|---|---|
| type | Davis | -The element can hold these values
| Required |
| value | Davis | - | Required |
EventQueryTriggerConfigType objectEventQuery object| Element | Type | Description | Required |
|---|---|---|---|
| query | string | DQL matcher expression defining which events to match. | Required |
| eventType | Event | Grail event type. The element can hold these values
| Optional |
EventType objectGrail event type.
DavisProblemTriggerConfigType objectDavisProblemConfig object| Element | Type | Description | Required |
|---|---|---|---|
| entityTagsMatch | Entity | - | Optional |
| entityTags | Entity | - | Optional |
| boolean | DEPRECATED Trigger on Davis problem open only or also on close. Deprecated — use triggerOn instead. | Optional | |
| triggerOn | Trigger | Problem state to trigger on. "open" (active only), "open-and-close" (both phases), or "close" (closure only). When unset, falls back to onProblemClose for backward compatibility. | Optional |
| categories | Davis | - | Required |
| customFilter | string | Additional DQL matcher expression to further filter events to match. | Optional |
| analysisReady | boolean | Run only after first root cause analysis run completed. | Optional |
| severityThreshold | integer | Triggers only for problems whose severity is this value or more severe. Lower numbers are more severe (1 = critical, 5 = informational), so 3 matches severities 1, 2, and 3. | Optional |
| triggerOnUpdateFields | Trigger | Problem event fields tracked for value changes. Changes to any selected field cause re-triggering. | Optional |
| problemOpenDuration | integer | Minimum problem duration in minutes before the trigger fires. The element can hold these values
| Optional |
EntityTagsMatch objectEvent must match all or any of the entity tags.
EntityTags objectEntity tags to match by key and (optional) values. For example {"foo": [], "bar": ["a", "b", "c"]}
TriggerOn objectDavisProblemCategories object| Element | Type | Description | Required |
|---|---|---|---|
| monitoringUnavailable | boolean | - | Optional |
| availability | boolean | - | Optional |
| error | boolean | - | Optional |
| slowdown | boolean | - | Optional |
| resource | boolean | - | Optional |
| custom | boolean | - | Optional |
| info | boolean | - | Optional |
TriggerOnUpdateFields objectDavisEventTriggerConfigType objectDavisEventConfig object| Element | Type | Description | Required |
|---|---|---|---|
| entityTagsMatch | Entity | - | Optional |
| entityTags | Entity | - | Optional |
| boolean | DEPRECATED Trigger on Davis event open only or also on close. Deprecated — use triggerOn instead. | Optional | |
| triggerOn | Trigger | Event state to trigger on. "open" (active only), "open-and-close" (both phases), or "close" (closure only). When unset, falls back to onProblemClose for backward compatibility. | Optional |
| names | Davis | - | Optional |
| string[] | DEPRECATED - | Optional | |
| customFilter | string | Additional DQL matcher expression to further filter events to match. | Optional |
| maintenanceWindowTriggerBehavior | Maintenance | - | Optional |
DavisEventName object| Element | Type | Description | Required |
|---|---|---|---|
| match | Davis | Davis event name must equal or contain the string provided. The element can hold these values
| Required |
| name | string | - | Required |
DavisEventNameMatch objectDavis event name must equal or contain the string provided.
MaintenanceWindowTriggerBehaviorType objectSpecifies when to trigger based on maintenance window status.
EventNotificationInput object| Element | Type | Description | Required |
|---|---|---|---|
| subject | string | - | Optional |
| content | string | - | Optional |
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{"title": "string","resourceId": "string","notificationType": "string","triggerConfiguration": {"type": "event","value": {"eventType": "bizevents","query": "event.kind == \"CUSTOM_KIND\""}},"input": {"subject": "string","content": "string"},"appId": "string"}
| Code | Type | Description |
|---|---|---|
| 200 | Event | - |
| 4XX | Error | - |
| 5XX | Error | - |
EventNotification object| Element | Type | Description |
|---|---|---|
| id | string | - |
| title | string | - |
| resourceId | string | Unique identifier of resource to notify on. Used to determine if there is a notification registered for a resource in context of the app and notification type for a user. |
| notificationType | string | String that defines the type of a notification in context of an app. Allows to differentiate between multiple types of notifications in context of one app. |
| triggerConfiguration | Event | - |
| modificationInfo | Modification | - |
| input | Event | Input object consisting of subject and content. Supports automation expressions https://dt-url.net/workflows-expression-reference and markdown syntax. A template provided with an app ({notification_type}.notification-template.json) will take precedence over the input provided here. |
| appId | string | App id for registered notification. Optional, by default automatically inferred from the request. Only relevant for manual testing purposes via swagger. |
| owner | string | - |
EventTriggerConfig objectEventQueryTriggerConfig objectConfig for generic event triggers ("Event trigger"). No dedup — fires on every matching event.
| Element | Type | Description |
|---|---|---|
| type | Event | -The element can hold these values
|
| value | Event | - |
DavisProblemTriggerConfig objectConfig for Problem event triggers ("Problem trigger").
Deduplicated across a problem's lifecycle: fires once per phase selected by the trigger config (triggerOn, triggerOnUpdateFields), not on every update.
| Element | Type | Description |
|---|---|---|
| type | Davis | -The element can hold these values
|
| value | Davis | - |
DavisEventTriggerConfig objectConfig for Davis Event event triggers ("Davis event trigger").
Deduplicated across an event's lifecycle: fires once per phase selected by the trigger config (triggerOn), not on every update.
| Element | Type | Description |
|---|---|---|
| type | Davis | -The element can hold these values
|
| value | Davis | - |
EventQueryTriggerConfigType objectEventQuery object| Element | Type | Description |
|---|---|---|
| query | string | DQL matcher expression defining which events to match. |
| eventType | Event | Grail event type. The element can hold these values
|
EventType objectGrail event type.
DavisProblemTriggerConfigType objectDavisProblemConfig object| Element | Type | Description |
|---|---|---|
| entityTagsMatch | Entity | - |
| entityTags | Entity | - |
| boolean | DEPRECATED Trigger on Davis problem open only or also on close. Deprecated — use triggerOn instead. | |
| triggerOn | Trigger | Problem state to trigger on. "open" (active only), "open-and-close" (both phases), or "close" (closure only). When unset, falls back to onProblemClose for backward compatibility. |
| categories | Davis | - |
| customFilter | string | Additional DQL matcher expression to further filter events to match. |
| analysisReady | boolean | Run only after first root cause analysis run completed. |
| severityThreshold | integer | Triggers only for problems whose severity is this value or more severe. Lower numbers are more severe (1 = critical, 5 = informational), so 3 matches severities 1, 2, and 3. |
| triggerOnUpdateFields | Trigger | Problem event fields tracked for value changes. Changes to any selected field cause re-triggering. |
| problemOpenDuration | integer | Minimum problem duration in minutes before the trigger fires. The element can hold these values
|
EntityTagsMatch objectEvent must match all or any of the entity tags.
EntityTags objectEntity tags to match by key and (optional) values. For example {"foo": [], "bar": ["a", "b", "c"]}
TriggerOn objectDavisProblemCategories object| Element | Type | Description |
|---|---|---|
| monitoringUnavailable | boolean | - |
| availability | boolean | - |
| error | boolean | - |
| slowdown | boolean | - |
| resource | boolean | - |
| custom | boolean | - |
| info | boolean | - |
TriggerOnUpdateFields objectDavisEventTriggerConfigType objectDavisEventConfig object| Element | Type | Description |
|---|---|---|
| entityTagsMatch | Entity | - |
| entityTags | Entity | - |
| boolean | DEPRECATED Trigger on Davis event open only or also on close. Deprecated — use triggerOn instead. | |
| triggerOn | Trigger | Event state to trigger on. "open" (active only), "open-and-close" (both phases), or "close" (closure only). When unset, falls back to onProblemClose for backward compatibility. |
| names | Davis | - |
| string[] | DEPRECATED - | |
| customFilter | string | Additional DQL matcher expression to further filter events to match. |
| maintenanceWindowTriggerBehavior | Maintenance | - |
DavisEventName object| Element | Type | Description |
|---|---|---|
| match | Davis | Davis event name must equal or contain the string provided. The element can hold these values
|
| name | string | - |
DavisEventNameMatch objectDavis event name must equal or contain the string provided.
MaintenanceWindowTriggerBehaviorType objectSpecifies when to trigger based on maintenance window status.
ModificationInfo object| Element | Type | Description |
|---|---|---|
| createdBy | string | - |
| createdTime | string | - |
| lastModifiedBy | string | - |
| lastModifiedTime | string | - |
EventNotificationInput object| Element | Type | Description |
|---|---|---|
| subject | string | - |
| content | string | - |
ErrorEnvelope object| Element | Type | Description |
|---|---|---|
| error | Error | - |
Error object| Element | Type | Description |
|---|---|---|
| message | string | - |
| code | integer | - |
| details | Error | - |
ErrorDetails object| Element | Type | Description |
|---|---|---|
| errorCode | string | - |
| errorRef | string | - |
{"id": "string","title": "string","resourceId": "string","notificationType": "string","triggerConfiguration": {"type": "event","value": {"eventType": "bizevents","query": "event.kind == \"CUSTOM_KIND\""}},"modificationInfo": {"createdBy": "string","createdTime": "string","lastModifiedBy": "string","lastModifiedTime": "string"},"input": {"subject": "string","content": "string"},"appId": "string","owner": "string"}
{"error": {"message": "string","code": 1,"details": {"errorCode": "string","errorRef": "string"}}}