Palo Alto Networks · JSON Structure

Sase Multitenant Notifications Api Mt Notification List Structure

MtNotificationList schema from Multi-Tenant Notifications API

Type: array Properties: 0
Cloud SecurityCybersecurityFirewallNetwork SecuritySASESOARThreat IntelligenceXDR

MtNotificationList is a JSON Structure definition published by Palo Alto Networks. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$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-list-structure.json",
  "name": "MtNotificationList",
  "description": "MtNotificationList schema from Multi-Tenant Notifications API",
  "type": "array",
  "items": {
    "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"
    ]
  }
}