Skip to content

Web notifications

Web notifications is the resource representing a user's notification

Endpoints

Skip to section
GET/v1/web-notifications
GET/v1/web-notifications/{notificationId}
PATCH/v1/web-notifications/{notificationId}
DELETE/v1/web-notifications/{notificationId}
PATCH/v1/web-notifications/all
DELETE/v1/web-notifications/all

Retrieve notifications matching the query.

manage

Facts GET /v1/web-notifications

Rate limit
Tier 1 (1000 requests per minute)

Query Parameters GET /v1/web-notifications

limit
optional, default=10, maximum=100
number

The number of notification entries to retrieved.

page
optional, default=1
number

Page number

read
optional
boolean

Read status of the notification

sort
optional, default='-created'
string

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

Enum:

+createdAt

-createdAt

+updatedAt

-updatedAt

Responses GET /v1/web-notifications

200
optional, application/json

An array of notification objects

400
optional, application/json

Invalid request parameters for querying users.

401
optional, application/json

Unauthorized request.

500
optional, application/json

Internal server error

GET/v1/web-notifications

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

Response GET /v1/web-notifications

{
  "data": [
    {
      "id": "string",
      "body": "string",
      "read": true,
      "action": "string",
      "userId": "string",
      "spaceId": "string",
      "tenantId": "string",
      "createdAt": "2023-01-26T11:56:44.581Z",
      "updatedAt": "2023-01-26T11:56:44.581Z",
      "resourceId": "string",
      "resourceType": "string"
    }
  ],
  "meta": {
    "unreadCount": 0
  },
  "links": {
    "next": {
      "href": "string"
    },
    "prev": {
      "href": "string"
    },
    "self": {
      "href": "string"
    }
  }
}

Retrieve a single notification by Id.

manage

Facts GET /v1/web-notifications/{notificationId}

Rate limit
Tier 1 (1000 requests per minute)

Path Parameters GET /v1/web-notifications/{notificationId}

notificationId
string<uid>

The id of the notification to retrieve.

Responses GET /v1/web-notifications/{notificationId}

200
optional, application/json

Successfully got notification.

401
optional, application/json

Unauthorized request.

404
optional, application/json

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

500
optional, application/json

Internal server error

GET/v1/web-notifications/{notificationId}

curl "https://your-tenant.us.qlikcloud.com/api/v1/web-notifications/{notificationId}" \
 -H "Authorization: Bearer <API-key>"

Response GET /v1/web-notifications/{notificationId}

{
  "id": "string",
  "body": "string",
  "read": true,
  "action": "string",
  "userId": "string",
  "spaceId": "string",
  "tenantId": "string",
  "createdAt": "2023-01-26T11:56:44.581Z",
  "updatedAt": "2023-01-26T11:56:44.581Z",
  "resourceId": "string",
  "resourceType": "string"
}

Patch a notification.

manage

Facts PATCH /v1/web-notifications/{notificationId}

Rate limit
Tier 2 (100 requests per minute)

Path Parameters PATCH /v1/web-notifications/{notificationId}

notificationId
string<uid>

The id of the notification to update.

Request Body PATCH /v1/web-notifications/{notificationId}

optional, application/json

No description

Responses PATCH /v1/web-notifications/{notificationId}

204
optional, application/json

Successfully patched marked notification.

400
optional, application/json

Unsupported patch request.

401
optional, application/json

Unauthorized request.

404
optional, application/json

Notification not found.

500
optional, application/json

Internal server error

PATCH/v1/web-notifications/{notificationId}

curl "https://your-tenant.us.qlikcloud.com/api/v1/web-notifications/{notificationId}" \
 -X PATCH \
 -H "Authorization: Bearer <API-key>" \
 -H "Content-type: application/json" \
 -d '[{"op":"replace","path":"/read","value":true}]'

Request PATCH /v1/web-notifications/{notificationId}

[
  {
    "op": "replace",
    "path": "/read",
    "value": true
  }
]

Response PATCH /v1/web-notifications/{notificationId}

{
  "unreadCount": 0
}

Delete a notification.

manage

Facts DELETE /v1/web-notifications/{notificationId}

Rate limit
Tier 2 (100 requests per minute)

Path Parameters DELETE /v1/web-notifications/{notificationId}

notificationId
string<uid>

The id of the notification to delete.

Responses DELETE /v1/web-notifications/{notificationId}

204
optional, application/json

Successfully deleted notification.

401
optional, application/json

Unauthorized request.

404
optional, application/json

Notification not found.

500
optional, application/json

Internal server error

DELETE/v1/web-notifications/{notificationId}

curl "https://your-tenant.us.qlikcloud.com/api/v1/web-notifications/{notificationId}" \
 -X DELETE \
 -H "Authorization: Bearer <API-key>"

Response DELETE /v1/web-notifications/{notificationId}

{
  "unreadCount": 0
}

Patch all notifications.

manage

Facts PATCH /v1/web-notifications/all

Rate limit
Tier 2 (100 requests per minute)

Request Body PATCH /v1/web-notifications/all

optional, application/json

No description

Responses PATCH /v1/web-notifications/all

204
optional, application/json

Successfully marked all notification.

400
optional, application/json

Unsupported patch request.

401
optional, application/json

Unauthorized request.

500
optional, application/json

Internal server error

PATCH/v1/web-notifications/all

curl "https://your-tenant.us.qlikcloud.com/api/v1/web-notifications/all" \
 -X PATCH \
 -H "Authorization: Bearer <API-key>" \
 -H "Content-type: application/json" \
 -d '[{"op":"replace","path":"/read","value":true}]'

Request PATCH /v1/web-notifications/all

[
  {
    "op": "replace",
    "path": "/read",
    "value": true
  }
]

Response PATCH /v1/web-notifications/all

{
  "unreadCount": 0
}

Delete all notifications.

manage

Facts DELETE /v1/web-notifications/all

Rate limit
Tier 2 (100 requests per minute)

Responses DELETE /v1/web-notifications/all

204
optional, application/json

Successfully deleted notification.

401
optional, application/json

Unauthorized request.

500
optional, application/json

Internal server error

DELETE/v1/web-notifications/all

curl "https://your-tenant.us.qlikcloud.com/api/v1/web-notifications/all" \
 -X DELETE \
 -H "Authorization: Bearer <API-key>"

Response DELETE /v1/web-notifications/all

{
  "unreadCount": 0
}

Error

object

An error object.

Properties

code
string

The error code.

title
string

Summary of the problem.

status
optional
integer

The HTTP status code.

message
optional
string

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

Errors

object

A representation of the errors encountered from the HTTP request.

Properties

errors
optional

No description

Notifications links

Properties

next
optional
object

No description

prev
optional
object

No description

self
optional
object

No description

Meta

object

Notifications meta data

Properties

unreadCount
optional, minimum=0, maximum=500
number

The total number of unread notification.

Notification

object

Properties

id
string<uid>

No description

body
string

No description

read
boolean

No description

action
optional
string<string>

No description

userId
string<uid>

No description

spaceId
optional
string<uid>

No description

tenantId
optional
string<uid>

No description

createdAt
string<date>

No description

updatedAt
string<date>

No description

resourceId
optional
string<string>

No description

resourceType
optional
string<string>

No description

NotificationPatch

object

A JSON Patch document as defined in http://tools.ietf.org/html/rfc6902.

Properties

op
string

The operation to be performed.

Enum:

replace

path
string

The path for the given resource field to patch.

Enum:

/description

value
string

The value to be used for this operation.

NotificationPatchSchema

Array<NotificationPatch>

An array of JSON Patch documents

Properties

op
string

The operation to be performed.

Enum:

replace

path
string

The path for the given resource field to patch.

Enum:

/description

value
string

The value to be used for this operation.

Notifications

object

Properties

data
optional

No description

meta
optional

Notifications meta data

links
optional

Notifications links

v0.574.0
Was this page helpful?