# Notifications API

The Notifications operations of the BuildBase HTTP API: method, path, sign-in, request fields, answers and errors for each.

8 operations, 6 fully described. For how this part of BuildBase works, start with the [guide](/notifications/overview).

| Method | Path                                                                                                             | What it does                                             |
| ------ | ---------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| GET    | [`/api/v1/public/notifications`](/http-api/reference/notifications/notifications-list)                           | List the signed-in user's notifications                  |
| POST   | [`/api/v1/public/notifications/read-all`](/http-api/reference/notifications/notifications-read-all-create)       | Mark all of the signed-in user's notifications as read   |
| POST   | [`/api/v1/public/notifications/seen`](/http-api/reference/notifications/notifications-seen-create)               | Mark the signed-in user's notifications as seen          |
| GET    | [`/api/v1/public/notifications/unread-count`](/http-api/reference/notifications/notifications-unread-count-list) | Get the signed-in user's unread notification counts      |
| POST   | [`/api/v1/public/notifications/{id}/archive`](/http-api/reference/notifications/notifications-archive-create)    | Archive one of the signed-in user's notifications        |
| DELETE | [`/api/v1/public/notifications/{id}/archive`](/http-api/reference/notifications/notifications-archive-delete)    | Unarchive one of the signed-in user's notifications      |
| POST   | [`/api/v1/public/notifications/{id}/read`](/http-api/reference/notifications/notifications-read-create)          | Mark one of the signed-in user's notifications as read   |
| POST   | [`/api/v1/public/notifications/{id}/unread`](/http-api/reference/notifications/notifications-unread-create)      | Mark one of the signed-in user's notifications as unread |

## Related

- [API reference](/http-api/reference): every tag
- [Notifications guide](/notifications/overview)
