Retrieve Notifications | Project Manager

1 curl -G https://api.projectmanager.com/api/data/notifications \ 2 -H "x-integration-name: foo" \ 3 -H "Authorization: Bearer <token>" \ 4 -d lastId=foo \ 5 -d senderId=foo \ 6 -d notificationTypes=foo \ 7 -d asFlatList=true

1 { 2 "error": { 3 "additionalErrors": [ 4 "foo" 5 ], 6 "message": "foo", 7 "technicalError": "foo", 8 "validationErrors": {} 9 }, 10 "success": true, 11 "hasError": true, 12 "statusCode": "Continue", 13 "data": { 14 "items": [ 15 { 16 "id": "foo", 17 "senderId": "foo", 18 "children": [ 19 { 20 "id": "foo", 21 "senderId": "foo", 22 "children": [ 23 { 24 "id": "foo", 25 "senderId": "foo", 26 "children": [ 27 { 28 "id": "foo", 29 "senderId": "foo", 30 "children": [ 31 {} 32 ], 33 "notificationType": "foo", 34 "createDate": "foo", 35 "subject": "foo", 36 "message": "foo", 37 "readDate": "foo", 38 "data": {} 39 } 40 ], 41 "notificationType": "foo", 42 "createDate": "foo", 43 "subject": "foo", 44 "message": "foo", 45 "readDate": "foo", 46 "data": { 47 "assigneeId": "foo", 48 "fileName": "foo", 49 "projectId": "foo", 50 "projectName": "foo", 51 "projectShortId": "foo", 52 "senderFirstName": "foo", 53 "shareId": "foo", 54 "taskId": "foo", 55 "taskName": "foo", 56 "taskShortId": "foo", 57 "view": "foo" 58 } 59 } 60 ], 61 "notificationType": "foo", 62 "createDate": "foo", 63 "subject": "foo", 64 "message": "foo", 65 "readDate": "foo", 66 "data": { 67 "assigneeId": "foo", 68 "fileName": "foo", 69 "projectId": "foo", 70 "projectName": "foo", 71 "projectShortId": "foo", 72 "senderFirstName": "foo", 73 "shareId": "foo", 74 "taskId": "foo", 75 "taskName": "foo", 76 "taskShortId": "foo", 77 "view": "foo" 78 } 79 } 80 ], 81 "notificationType": "foo", 82 "createDate": "foo", 83 "subject": "foo", 84 "message": "foo", 85 "readDate": "foo", 86 "data": { 87 "assigneeId": "foo", 88 "fileName": "foo", 89 "projectId": "foo", 90 "projectName": "foo", 91 "projectShortId": "foo", 92 "senderFirstName": "foo", 93 "shareId": "foo", 94 "taskId": "foo", 95 "taskName": "foo", 96 "taskShortId": "foo", 97 "view": "foo" 98 } 99 } 100 ], 101 "totalCount": 42, 102 "unreadCount": 42 103 } 104 }

Retrieve the most recent notifications for the current user, along with the amount of notifications.

A notification represents a message sent to a user to inform them of relevant actions or events within their workspace. Notifications are ephemeral and may be deleted when they are no longer needed. When a user has more than 1,000 pending notifications some old notifications will be deleted automatically.

This API retrieves 500 notifications at a time. To fetch more than 500 notifications, repeat this API call using the parameter lastId of the oldest notification from each batch to fetch the next 500 notifications.

Query parameters

lastIdstringOptionalformat: "uuid"

To continue loading more notifications in a series of requests, provide the ID of the oldest notification from the currently loaded batch as the lastId parameter

senderIdstringOptionalformat: "uuid"

Filter the notifications to only those sent by the user with the specified ID

notificationTypeslist of stringsOptional

Specifies the types of notifications to return. If not provided, all notifications will be returned.

asFlatListbooleanOptionalDefaults to false

If set to true all notifications will be returned as a flat list, otherwise they will be grouped by parent in the same manner as displayed in the UI.

Response

Success

errorobject or null

If the API call failed, this will contain information about the error that occurred.

successboolean or null

True if the API call succeeded; false otherwise.

hasErrorboolean or null

True if the API call failed.

statusCodeobject or null

The HTTP code of the response.

dataobject or null

Information about notifications for the current user. A notification represents a message sent to a user to inform them of relevant actions or events within their workspace. Notifications are ephemeral and may be deleted when they are no longer needed. When a user has more than 1,000 pending notifications some old notifications will be deleted automatically.

Headers

Query parameters

Response