Problems Problem Notification Payload Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/dynatrace/refs/heads/main/json-structure/problems-problem-notification-payload-structure.json",
  "description": "The webhook notification payload delivered by Dynatrace when a problem lifecycle event occurs. Contains both summary fields for quick processing and the full ProblemDetailsJSON for detailed analysis.",
  "type": "object",
  "properties": {
    "ProblemID": {
      "type": "string",
      "description": "The human-readable problem identifier displayed in the Dynatrace UI, e.g., P-123456.",
      "example": "P-123456"
    },
    "ProblemTitle": {
      "type": "string",
      "description": "The title of the problem generated by the Davis AI engine, describing the nature of the detected anomaly.",
      "example": "High failure rate on payment-service"
    },
    "ProblemURL": {
      "type": "uri",
      "description": "The full URL to the problem detail page in the Dynatrace UI, allowing recipients to navigate directly to the problem.",
      "example": "https://mySampleEnv.live.dynatrace.com/#problems/problemdetail;pid=-1234567890123456789_V2"
    },
    "ProblemSeverity": {
      "type": "string",
      "description": "The severity level classification of the problem.",
      "enum": [
        "AVAILABILITY",
        "ERROR",
        "PERFORMANCE",
        "RESOURCE_CONTENTION",
        "CUSTOM_ALERT"
      ],
      "example": "PERFORMANCE"
    },
    "ProblemStatus": {
      "type": "string",
      "description": "The current lifecycle status of the problem at the time of notification.",
      "enum": [
        "OPEN",
        "RESOLVED"
      ],
      "example": "OPEN"
    },
    "ImpactedEntities": {
      "type": "array",
      "description": "The list of monitored entities that are experiencing service degradation as a result of the problem.",
      "items": {
        "$ref": "#/components/schemas/ImpactedEntity"
      },
      "example": [
        {
          "Entity": "SERVICE-ABCDEF1234567890",
          "Name": "payment-service"
        }
      ]
    },
    "ImpactedEntityNames": {
      "type": "string",
      "description": "A comma-separated string of display names for all impacted entities, for use in simple notification templates.",
      "example": "payment-service, checkout-service"
    },
    "Tags": {
      "type": "string",
      "description": "A comma-separated string of tags applied to the impacted entities, for use in routing or filtering notification handlers.",
      "example": "env:production, team:backend"
    },
    "State": {
      "type": "string",
      "description": "The state of the problem notification. OPEN for new or ongoing problems, RESOLVED for resolved problems, MERGED for merged problems.",
      "enum": [
        "OPEN",
        "RESOLVED",
        "MERGED"
      ],
      "example": "OPEN"
    },
    "ProblemDetailsJSON": {
      "$ref": "#/components/schemas/ProblemDetails"
    }
  },
  "name": "ProblemNotificationPayload"
}