Try it free

List self notifications

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026
  • Deprecated

List self notifications in Dynatrace with the Notification API, filtering by app, owner, resource, type, search, ordering, limit, and offset.

GETSaaShttps://{your-environment-id}.apps.dynatrace.com/platform/notification/v1/self-notifications

Overview

You use the query parameters appId, limit, notificationType, offset, ordering, owner, resourceId, and search to narrow the self notifications returned. The response provides the matching self notifications from Dynatrace.

Authentication

To execute this request, you need a platform token or OAuth access token with notification:self-notifications:read scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
appIdstring-queryOptional
limitinteger

Number of results to return per page.

queryOptional
notificationTypestring-queryOptional
offsetinteger

The initial index from which to return the results.

queryOptional
orderingstring

Which field to use when ordering the results.

queryOptional
ownerstring-queryOptional
resourceIdstring-queryOptional
searchstring

A search term.

queryOptional

Response

Response codes

CodeTypeDescription
200PaginatedSelfNotificationList-
4XXErrorEnvelope-

Response body objects

The PaginatedSelfNotificationList object

ElementTypeDescription
countinteger-
resultsSelfNotification[]-

The SelfNotification object

ElementTypeDescription
idstring-
titlestring-
resourceIdstring

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.

notificationTypestring

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.

triggerConfigurationEventQueryTriggerConfig | DavisProblemTriggerConfig | DavisEventTriggerConfig-
modificationInfoModificationInfo-
inputSelfNotificationInput

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.

appIdstring

App id for registered notification. Optional, by default automatically inferred from the request. Only relevant for manual testing purposes via swagger.

ownerstring-

The EventTriggerConfig object

The EventQueryTriggerConfig object

Config for generic event triggers ("Event trigger"). No dedup — fires on every matching event.

ElementTypeDescription
typeEventQueryTriggerConfigType-
The element can hold these values
  • event
valueEventQuery-

The DavisProblemTriggerConfig object

Config 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.

ElementTypeDescription
typeDavisProblemTriggerConfigType-
The element can hold these values
  • davis-problem
valueDavisProblemConfig-

The DavisEventTriggerConfig object

Config 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.

ElementTypeDescription
typeDavisEventTriggerConfigType-
The element can hold these values
  • davis-event
valueDavisEventConfig-

The EventQueryTriggerConfigType object

The EventQuery object

ElementTypeDescription
querystring

DQL matcher expression defining which events to match.

eventTypeEventType

Grail event type.

The element can hold these values
  • events
  • bizevents
  • dt.system.events
  • security.events

The EventType object

Grail event type.

The DavisProblemTriggerConfigType object

The DavisProblemConfig object

ElementTypeDescription
entityTagsMatchEntityTagsMatch-
entityTagsEntityTags-
onProblemCloseboolean

DEPRECATED

Trigger on Davis problem open only or also on close. Deprecated — use triggerOn instead.

triggerOnTriggerOn

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.

categoriesDavisProblemCategories-
customFilterstring

Additional DQL matcher expression to further filter events to match.

analysisReadyboolean

Run only after first root cause analysis run completed.

severityThresholdinteger

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.

triggerOnUpdateFieldsTriggerOnUpdateFields[]

Problem event fields tracked for value changes. Changes to any selected field cause re-triggering.

problemOpenDurationinteger

Minimum problem duration in minutes before the trigger fires.

The element can hold these values
  • 5
  • 10
  • 15
  • 30
  • 60
  • 120
  • 240
  • 1440
  • 10080

The EntityTagsMatch object

Event must match all or any of the entity tags.

The EntityTags object

Entity tags to match by key and (optional) values. For example {"foo": [], "bar": ["a", "b", "c"]}

The TriggerOn object

The DavisProblemCategories object

ElementTypeDescription
monitoringUnavailableboolean-
availabilityboolean-
errorboolean-
slowdownboolean-
resourceboolean-
customboolean-
infoboolean-

The TriggerOnUpdateFields object

The DavisEventTriggerConfigType object

The DavisEventConfig object

ElementTypeDescription
entityTagsMatchEntityTagsMatch-
entityTagsEntityTags-
onProblemCloseboolean

DEPRECATED

Trigger on Davis event open only or also on close. Deprecated — use triggerOn instead.

triggerOnTriggerOn

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.

namesDavisEventName[]-
typesstring[]

DEPRECATED

-
customFilterstring

Additional DQL matcher expression to further filter events to match.

maintenanceWindowTriggerBehaviorMaintenanceWindowTriggerBehaviorType-

The DavisEventName object

ElementTypeDescription
matchDavisEventNameMatch

Davis event name must equal or contain the string provided.

The element can hold these values
  • equals
  • contains
namestring-

The DavisEventNameMatch object

Davis event name must equal or contain the string provided.

The MaintenanceWindowTriggerBehaviorType object

Specifies when to trigger based on maintenance window status.

The ModificationInfo object

ElementTypeDescription
createdBystring-
createdTimestring-
lastModifiedBystring-
lastModifiedTimestring-

The SelfNotificationInput object

ElementTypeDescription
subjectstring-
contentstring-

The ErrorEnvelope object

ElementTypeDescription
errorError-

The Error object

ElementTypeDescription
messagestring-
codeinteger-
detailsErrorDetails-

The ErrorDetails object

ElementTypeDescription
errorCodestring-
errorRefstring-

Response body JSON models

{
  "count": 123,
  "results": [
    {
      "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"
    }
  }
}
Related tags
Platform APIDynatrace Platform