Web notifications

Web notifications is the resource representing a user's notification

Download specification

Retrieve notifications matching the query.

Facts

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

Query Parameters

  • limitnumber

    The number of notification entries to retrieved.

    minimum = 0, maximum = 100, default = 10, default = 10

  • pagenumber

    Page number

    default = 1, default = 1

  • readboolean

    Read status of the notification

  • resourceTypestring

    Filter by resource types. If passing more than 1 resource type, use comma seperated string.

  • sortstring

    The field to sort by, with +/- prefix indicating sort order

    Can be one of: "+createdAt""-createdAt""+updatedAt""-updatedAt"

    default = "-createdAt"

Responses

200

An array of notification objects

  • application/jsonobject
    Show application/json properties
    • dataarray of objects
      Show data properties
      • idstring
        Required

        format = "uid"

      • bodystring
        Required
      • metaobject
        Required
      • readboolean
        Required
      • actionstring

        format = "string"

      • userIdstring
        Required

        format = "uid"

      • spaceIdstring

        format = "uid"

      • tenantIdstring

        format = "uid"

      • createdAtstring
        Required

        format = "date"

      • spaceTypestring
      • updatedAtstring
        Required

        format = "date"

      • resourceIdstring

        format = "string"

      • resourceTypestring

        format = "string"

      • subResourceTypestring

        format = "string"

    • metaobject

      Notifications meta data

      Show meta properties
      • unreadCountnumber

        The total number of unread notification.

        minimum = 0, maximum = 500

    • linksobject

      Notifications links

      Show links properties
      • nextobject
        Show next properties
        • hrefstring
      • prevobject
        Show prev properties
        • hrefstring
      • selfobject
        Show self properties
        • hrefstring

400

Invalid request parameters for querying users.

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.

401

Unauthorized request.

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.

500

Internal server error

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.
GET /api/v1/web-notifications 
import { createQlikApi } from '@qlik/api'


const qlik = createQlikApi({
  hostConfig: {
    host: 'https://your-tenant.us.qlikcloud.com',
    apiKey: '<access-token>',
  },
})


await qlik.webNotifications.getNotifications({})
This API is not included yet in qlik-cli
curl "https://your-tenant.us.qlikcloud.com/api/v1/web-notifications" \
-H "Authorization: Bearer <access_token>"

Example Response

{
  "data": [
    {
      "id": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69",
      "body": "string",
      "meta": {},
      "read": true,
      "action": "string",
      "userId": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69",
      "spaceId": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69",
      "tenantId": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69",
      "createdAt": "string",
      "spaceType": "string",
      "updatedAt": "string",
      "resourceId": "string",
      "resourceType": "string",
      "subResourceType": "string"
    }
  ],
  "meta": {
    "unreadCount": 0
  },
  "links": {
    "next": {
      "href": "string"
    },
    "prev": {
      "href": "string"
    },
    "self": {
      "href": "string"
    }
  }
}

Retrieve a single notification by Id.

Facts

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

Path Parameters

  • notificationIdstring
    Required

    The id of the notification to retrieve.

    format = "uid"

Responses

200

Successfully got notification.

  • application/jsonobject
    Show application/json properties
    • idstring
      Required

      format = "uid"

    • bodystring
      Required
    • metaobject
      Required
    • readboolean
      Required
    • actionstring

      format = "string"

    • userIdstring
      Required

      format = "uid"

    • spaceIdstring

      format = "uid"

    • tenantIdstring

      format = "uid"

    • createdAtstring
      Required

      format = "date"

    • spaceTypestring
    • updatedAtstring
      Required

      format = "date"

    • resourceIdstring

      format = "string"

    • resourceTypestring

      format = "string"

    • subResourceTypestring

      format = "string"

401

Unauthorized request.

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.

404

Not found when user tries to get notification they do not own.

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.

500

Internal server error

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.
GET /api/v1/web-notifications/{notificationId} 
import { createQlikApi } from '@qlik/api'


const qlik = createQlikApi({
  hostConfig: {
    host: 'https://your-tenant.us.qlikcloud.com',
    apiKey: '<access-token>',
  },
})


await qlik.webNotifications.getNotification(
  'TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69',
)
This API is not included yet in qlik-cli
curl "https://your-tenant.us.qlikcloud.com/api/v1/web-notifications/{notificationId}" \
-H "Authorization: Bearer <access_token>"

Example Response

{
  "id": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69",
  "body": "string",
  "meta": {},
  "read": true,
  "action": "string",
  "userId": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69",
  "spaceId": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69",
  "tenantId": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69",
  "createdAt": "string",
  "spaceType": "string",
  "updatedAt": "string",
  "resourceId": "string",
  "resourceType": "string",
  "subResourceType": "string"
}

Patch a notification.

Facts

Rate limit Tier 2 (100 requests per minute)
Categories manage

Path Parameters

  • notificationIdstring
    Required

    The id of the notification to update.

    format = "uid"

Request Body

Required
  • application/jsonarray of objects

    An array of JSON Patch documents

    Show application/json properties
    • opstring
      Required

      The operation to be performed.

      Can be one of: "replace"

    • pathstring
      Required

      The path for the given resource field to patch.

      Can be one of: "/read"

    • valuestring
      Required

      The value to be used for this operation.

Responses

204

Successfully patched marked notification.

  • application/jsonobject

    Notifications meta data

    Show application/json properties
    • unreadCountnumber

      The total number of unread notification.

      minimum = 0, maximum = 500

400

Unsupported patch request.

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.

401

Unauthorized request.

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.

404

Notification not found.

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.

500

Internal server error

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.
PATCH /api/v1/web-notifications/{notificationId} 
import { createQlikApi } from '@qlik/api'


const qlik = createQlikApi({
  hostConfig: {
    host: 'https://your-tenant.us.qlikcloud.com',
    apiKey: '<access-token>',
  },
})


await qlik.webNotifications.patchNotification(
  'TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69',
  [
    {
      op: 'replace',
      path: '/read',
      value: 'true',
    },
  ],
)
This API is not included yet in qlik-cli
curl "https://your-tenant.us.qlikcloud.com/api/v1/web-notifications/{notificationId}" \
-X PATCH \
-H "Content-type: application/json" \
-H "Authorization: Bearer <access_token>" \
-d '[{"op":"replace","path":"/read","value":true}]'

Example Response

{
  "unreadCount": 0
}

Delete a notification.

Facts

Rate limit Tier 2 (100 requests per minute)
Categories manage

Path Parameters

  • notificationIdstring
    Required

    The id of the notification to delete.

    format = "uid"

Responses

204

Successfully deleted notification.

  • application/jsonobject

    Notifications meta data

    Show application/json properties
    • unreadCountnumber

      The total number of unread notification.

      minimum = 0, maximum = 500

401

Unauthorized request.

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.

404

Notification not found.

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.

500

Internal server error

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.
DELETE /api/v1/web-notifications/{notificationId} 
import { createQlikApi } from '@qlik/api'


const qlik = createQlikApi({
  hostConfig: {
    host: 'https://your-tenant.us.qlikcloud.com',
    apiKey: '<access-token>',
  },
})


await qlik.webNotifications.deleteNotification(
  'TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69',
)
This API is not included yet in qlik-cli
curl "https://your-tenant.us.qlikcloud.com/api/v1/web-notifications/{notificationId}" \
-X DELETE \
-H "Authorization: Bearer <access_token>"

Example Response

{
  "unreadCount": 0
}

Patch all notifications.

Facts

Rate limit Tier 2 (100 requests per minute)
Categories manage

Request Body

Required
  • application/jsonarray of objects

    An array of JSON Patch documents

    Show application/json properties
    • opstring
      Required

      The operation to be performed.

      Can be one of: "replace"

    • pathstring
      Required

      The path for the given resource field to patch.

      Can be one of: "/read"

    • valuestring
      Required

      The value to be used for this operation.

Responses

204

Successfully marked all notification.

  • application/jsonobject

    Notifications meta data

    Show application/json properties
    • unreadCountnumber

      The total number of unread notification.

      minimum = 0, maximum = 500

400

Unsupported patch request.

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.

401

Unauthorized request.

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.

500

Internal server error

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.
PATCH /api/v1/web-notifications/all 
import { createQlikApi } from '@qlik/api'


const qlik = createQlikApi({
  hostConfig: {
    host: 'https://your-tenant.us.qlikcloud.com',
    apiKey: '<access-token>',
  },
})


await qlik.webNotifications.patchNotifications([
  { op: 'replace', path: '/read', value: 'true' },
])
This API is not included yet in qlik-cli
curl "https://your-tenant.us.qlikcloud.com/api/v1/web-notifications/all" \
-X PATCH \
-H "Content-type: application/json" \
-H "Authorization: Bearer <access_token>" \
-d '[{"op":"replace","path":"/read","value":true}]'

Example Response

{
  "unreadCount": 0
}

Delete all notifications.

Facts

Rate limit Tier 2 (100 requests per minute)
Categories manage

Responses

204

Successfully deleted notification.

  • application/jsonobject

    Notifications meta data

    Show application/json properties
    • unreadCountnumber

      The total number of unread notification.

      minimum = 0, maximum = 500

401

Unauthorized request.

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.

500

Internal server error

  • application/jsonobject

    A representation of the errors encountered from the HTTP request.

    Show application/json properties
    • errorsarray of objects

      An error object.

      Show errors properties
      • codestring
        Required

        The error code.

      • titlestring
        Required

        Summary of the problem.

      • statusinteger

        The HTTP status code.

      • messagestring

        A human-readable explanation specific to this occurrence of the problem.
DELETE /api/v1/web-notifications/all 
import { createQlikApi } from '@qlik/api'


const qlik = createQlikApi({
  hostConfig: {
    host: 'https://your-tenant.us.qlikcloud.com',
    apiKey: '<access-token>',
  },
})


await qlik.webNotifications.deleteNotifications()
This API is not included yet in qlik-cli
curl "https://your-tenant.us.qlikcloud.com/api/v1/web-notifications/all" \
-X DELETE \
-H "Authorization: Bearer <access_token>"

Example Response

{
  "unreadCount": 0
}