Skip to main content
The notifications endpoints work as an unread queue. GET /notifications/ returns only the unread notifications for the authenticated account, and DELETE /notifications/{notification_id} marks one as read. Deleting a notification is how you mark it read, and once you have, the list stops returning it. All requests go to https://api.nodemaven.com/api/v2/base/ and carry the header Authorization: x-api-key YOUR_API_KEY. See the NodeMaven API overview for the shared basics.

Endpoints

Listing unread notifications

GET /notifications/ lists the unread notifications for the account the API key belongs to. Notifications you have already marked read are not included, so the list is always the outstanding ones.

Marking a notification as read

DELETE /notifications/{notification_id} marks a single notification as read. The notification_id is a uuid in the path and it is required.
A successful call returns 204, so no body comes back. The status code alone confirms the notification is now read.