Web notifications
Web notifications is the resource representing a user's notification
Endpoints
Skip to sectionGET | /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.
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.
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.
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.
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.
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.
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
objectAn 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
objectA representation of the errors encountered from the HTTP request.
Properties
errors optional | No description |
Links
Notifications links
Properties
next optional object | No description |
prev optional object | No description |
self optional object | No description |
Meta
objectNotifications meta data
Properties
unreadCount optional, minimum=0, maximum=500 number | The total number of unread notification. |
Notification
objectProperties
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
objectA 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
objectProperties
data optional | No description |
meta optional | Notifications meta data |
links optional | Notifications links |