Sase Multitenant Notifications Api Mt Notification Structure

MtNotification schema from Multi-Tenant Notifications API
Type: object Properties: 11 Required: 7
Cloud SecurityCybersecurityFirewallNetwork SecuritySASESOARThreat IntelligenceXDR
MtNotification is a JSON Structure definition published by Palo Alto Networks, describing 11 properties, of which 7 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
Properties

id name body action createdTime aggKey impactedTenants impactedTenantCount notifReadState notifChannels notifType
Meta-schema: https://json-structure.org/meta/core/v0/#
JSON Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/palo-alto-networks/refs/heads/main/json-structure/sase-multitenant-notifications-api-mt-notification-structure.json",
  "name": "MtNotification",
  "description": "MtNotification schema from Multi-Tenant Notifications API",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Notification id"
    },
    "name": {
      "type": "string",
      "description": "Notification name"
    },
    "body": {
      "type": "string",
      "description": "Description of the notification"
    },
    "action": {
      "type": "string",
      "description": "Action to be taken on receiving the notification (if applicable)"
    },
    "createdTime": {
      "type": "double",
      "description": "Notification creation time"
    },
    "aggKey": {
      "type": "object",
      "description": "Multi-Tenant Notification Aggregation Key",
      "properties": {
        "tag": {
          "type": "object",
          "properties": {
            "tsgId": {
              "type": "string",
              "description": "TSG Id"
            },
            "notifType": {
              "type": "string",
              "description": "Notification Type",
              "enum": [
                "INCIDENTS",
                "UPGRADES",
                "ANNOUNCEMENTS"
              ]
            },
            "category": {
              "type": "string",
              "description": "Notification category - is associated with notification type"
            },
            "subCategory": {
              "type": "string",
              "description": "Notification sub-category - is associated with notification type and notification category"
            },
            "inAppFlag": {
              "type": "boolean",
              "description": "InApp Notification Flag"
            }
          },
          "required": [
            "tsgId",
            "notifType",
            "category",
            "subCategory",
            "inAppFlag"
          ]
        }
      }
    },
    "impactedTenants": {
      "type": "array",
      "description": "List of impacted tenants",
      "items": {
        "type": "string"
      }
    },
    "impactedTenantCount": {
      "type": "double",
      "description": "Number of tenants impacted by the multi-tenant notification"
    },
    "notifReadState": {
      "type": "string",
      "description": "Read state of the notification",
      "enum": [
        "READ",
        "UNREAD"
      ]
    },
    "notifChannels": {
      "type": "array",
      "description": "List of output channels that the notification is sent on",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Notification channel name"
          },
          "type": {
            "type": "string",
            "description": "Notification channel type",
            "enum": [
              "EMAIL",
              "WEBHOOK"
            ]
          },
          "emailChannelDetails": {
            "type": "object",
            "description": "Email channel details",
            "additionalProperties": {
              "type": "object",
              "properties": {
                "emails": {
                  "type": "array",
                  "description": "List of emails",
                  "items": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string",
                        "description": "Email owner name"
                      },
                      "emailId": {
                        "type": "string",
                        "description": "Email id"
                      }
                    },
                    "required": [
                      "name",
                      "emailId"
                    ]
                  }
                }
              },
              "required": [
                "emails"
              ]
            }
          },
          "webhookChannelDetails": {
            "type": "object",
            "description": "Webhook channel details",
            "additionalProperties": {
              "type": "object",
              "properties": {
                "urls": {
                  "type": "array",
                  "description": "List of Webhook URLs - do not include token in the URL",
                  "items": {
                    "type": "string"
                  }
                },
                "authType": {
                  "type": "string",
                  "description": "Webhook Authentication Type",
                  "enum": [
                    "NO_AUTH",
                    "TOKEN"
                  ]
                },
                "token": {
                  "type": "string",
                  "description": "Webhook token value"
                }
              },
              "required": [
                "urls",
                "authType",
                "token"
              ]
            }
          },
          "template": {
            "type": "object",
            "description": "Channel output template",
            "properties": {
              "name": {
                "type": "string",
                "description": "Output channel template name"
              },
              "templateJson": {
                "type": "string",
                "description": "JSON describing the output channel template"
              }
            }
          }
        },
        "required": [
          "name",
          "type"
        ]
      }
    },
    "notifType": {
      "type": "string",
      "description": "Notification type"
    }
  },
  "required": [
    "name",
    "body",
    "aggKey",
    "notifReadState",
    "impactedTenants",
    "impactedTenantCount",
    "notifChannels"
  ]
}