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
required
Tier 1 (1000 requests per minute)

Query Parameters GET /v1/web-notifications

limit
default=10, maximum=100
number

The number of notification entries to retrieved.

page
default=1
number

Page number

read
boolean

Read status of the notification

sort
default='-createdAt'
string

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

Enum:

+createdAt

-createdAt

+updatedAt

-updatedAt

Responses GET /v1/web-notifications

200
application/json

An array of notification objects

400
application/json

Invalid request parameters for querying users.

401
application/json

Unauthorized request.

500
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-11-29T00:09:33.516Z",
      "updatedAt": "2023-11-29T00:09:33.516Z",
      "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.

manage

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

Rate limit
required
Tier 1 (1000 requests per minute)

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

notificationId
required
string<uid>

The id of the notification to retrieve.

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

200
application/json

Successfully got notification.

401
application/json

Unauthorized request.

404
application/json

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

500
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-11-29T00:09:33.516Z",
  "updatedAt": "2023-11-29T00:09:33.516Z",
  "resourceId": "string",
  "resourceType": "string",
  "subResourceType": "string"
}

Patch a notification.

manage

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

Rate limit
required
Tier 2 (100 requests per minute)

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

notificationId
required
string<uid>

The id of the notification to update.

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

application/json

No description

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

204
application/json

Successfully patched marked notification.

400
application/json

Unsupported patch request.

401
application/json

Unauthorized request.

404
application/json

Notification not found.

500
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
required
Tier 2 (100 requests per minute)

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

notificationId
required
string<uid>

The id of the notification to delete.

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

204
application/json

Successfully deleted notification.

401
application/json

Unauthorized request.

404
application/json

Notification not found.

500
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
required
Tier 2 (100 requests per minute)

Request Body PATCH /v1/web-notifications/all

application/json

No description

Responses PATCH /v1/web-notifications/all

204
application/json

Successfully marked all notification.

400
application/json

Unsupported patch request.

401
application/json

Unauthorized request.

500
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
required
Tier 2 (100 requests per minute)

Responses DELETE /v1/web-notifications/all

204
application/json

Successfully deleted notification.

401
application/json

Unauthorized request.

500
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
required
string

The error code.

title
required
string

Summary of the problem.

status
integer

The HTTP status code.

message
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

No description

Notifications links

Properties

next
object

No description

prev
object

No description

self
object

No description

Meta

object

Notifications meta data

Properties

unreadCount
minimum=0, maximum=500
number

The total number of unread notification.

Notification

object

Properties

id
required
string<uid>

No description

body
required
string

No description

read
required
boolean

No description

action
string<string>

No description

userId
required
string<uid>

No description

spaceId
string<uid>

No description

tenantId
string<uid>

No description

createdAt
required
string<date>

No description

updatedAt
required
string<date>

No description

resourceId
string<string>

No description

resourceType
string<string>

No description

subResourceType
string<string>

No description

NotificationPatch

object

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

Properties

op
required
string

The operation to be performed.

Enum:

replace

path
required
string

The path for the given resource field to patch.

Enum:

/description

value
required
string

The value to be used for this operation.

NotificationPatchSchema

Array<NotificationPatch>

An array of JSON Patch documents

Properties

op
required
string

The operation to be performed.

Enum:

replace

path
required
string

The path for the given resource field to patch.

Enum:

/description

value
required
string

The value to be used for this operation.

Notifications

object

Properties

data

No description

meta

Notifications meta data

links

Notifications links

v0.879.8
Was this page helpful?