Notifications

Notifications is the resource representing the various notifications that notification-prep can render

Endpoints

GET

/api/v1/notifications

Facts

Rate limit	Tier 1 (1000 requests per minute)
Categories	manage

Query Parameters

localestring

If present, idenfies the language of the returned 'friendlyName' property.

default = "en"
manageableInHubstring

If present, represents the 'manageableInHub' value to filter by.

Can be one of: true

default = "if missing, no filtering is done"
subscribablestring

If present, represents the 'subscribable' value to filter by.

Can be one of: true

default = "if missing, no filtering is done"

Responses

200

Request completed successfully. See Results for ResultDetail on each notification.

application/jsonobject

Object containing array representing list of supported notifications
Show application/json properties
- notificationsarray of objects
  Required
  
  list of notifications
  
  Show notifications properties
  
  transportsarray of strings
  Required
  
  Type of Transport e.g. Email, Notification, Slack message etc...
  
  isSubscribableboolean
  Required
  
  Indicates if the notification can be subscribed to by users. If true, the object will also contain 'subscriptionInfo' object
  
  presentationInfoobject
  
  Object containing information pertaining to the presentaion of a notification in the UI
  
  Show presentationInfo properties
  
  scopesarray of strings
  
  Information about the scopes to which this notification applies. Helps determine the placement of the notification in the UI
  
  friendlyNamestring
  
  Localized, human-readable string representing the name of the notification suitable to use in a UI
  
  scopeFriendlyNamesobject
  
  Friendly name to be displayed for each scope.
  
  additional properties
  
  subscriptionInfoobject
  
  Object indicating what properties to use to subscribe to this notification via the 'Subscriptions' service. For info about its properties, refer to the Subscription sevice's API doc.
  
  Show subscriptionInfo properties
  
  actionstring
  Required
  
  targetstring
  
  resourceIdstring
  
  resourceTypestring
  Required
  
  resourceSubTypestring
  
  isManageableInHubboolean
  
  Indicates if the notification can be managed in the hub. If true, the object will also contain 'subscriptionInfo' object and a 'presentationInfo' object with a non-empty scopes array.
  
  notificationNamePatternstring
  Required
  
  Notification name pattern that will trigger this notification e.g resource.action

default

Request error. See Errors.

application/jsonobject

An error object.
Show application/json properties
- codestring
  Required
  
  The error code.
- titlestring
  Required
  
  Summary of the problem.
- detailstring
  
  A human-readable explanation specific to this occurrence of the problem.

GET /api/v1/notifications

curl "https://your-tenant.us.qlikcloud.com/api/v1/notifications" \
-H "Authorization: Bearer <access_token>"

const https = require('https')
  const data = JSON.stringify("")
  const options =   {
    'hostname': 'https://your-tenant.us.qlikcloud.com',
    'port': 443,
    'path': '/api/v1/notifications',
    'method': 'GET',
    'headers': {
      'Authorization': 'Bearer <access_token>'
    }
  }
  const req = https.request(options)

This API is not included yet in qlik-cli

Response

{
  "notifications": [
    {
      "transports": [
        "string"
      ],
      "isSubscribable": true,
      "presentationInfo": {
        "scopes": [
          "string"
        ],
        "friendlyName": "string",
        "scopeFriendlyNames": {}
      },
      "subscriptionInfo": {
        "action": "string",
        "target": "string",
        "resourceId": "string",
        "resourceType": "string",
        "resourceSubType": "string"
      },
      "isManageableInHub": true,
      "notificationNamePattern": "string"
    }
  ]
}