doc: update notification doc

This commit is contained in:
KernelDeimos 2024-06-15 19:13:11 -04:00
parent 5f5bd6bd24
commit 6f333bf262

View File

@ -2,13 +2,32 @@
Endpoints for managing notifications. Endpoints for managing notifications.
## POST `/notif/mark-awk` (auth required)
### Description
The `/notif/mark-awk` endpoint marks the specified notification
as "awknowledged". This indicates that the user has chosen to either
dismiss or act on this notification.
### Parameters
| Name | Description | Default Value |
| ---- | ----------- | -------- |
| uid | UUID associated with the notification | **required** |
### Response
This endpoint responds with an empty object (`{}`).
## POST `/notif/mark-read` (auth required) ## POST `/notif/mark-read` (auth required)
### Description ### Description
The `/notif/mark-read` endpoint marks the specified notification The `/notif/mark-read` endpoint marks that the specified notification
as "read". This indicates that the user has chosen to either has been shown to the user. It will not "pop up" as a new notification
dismiss or act on this notification. if they load the gui again.
### Parameters ### Parameters