Notifications API
Read and manage in-app notifications.
Generated from the Celerp 2.4.0 OpenAPI schema, 16 September 2026.
GET /notifications
List Notifications
List notifications for the current user, newest first.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
limit | query | -- | integer | -- |
offset | query | -- | integer | -- |
unread_only | query | -- | boolean | -- |
Responses
| Status | Description | Body |
|---|---|---|
200 | Successful Response | NotificationList |
422 | Validation Error | HTTPValidationError |
Example
curl -X GET http://localhost:8000/notifications \
-H "Authorization: Bearer $TOKEN"POST /notifications/read-all
Mark All Read
Mark all notifications as read for the current user.
Responses
| Status | Description | Body |
|---|---|---|
204 | Successful Response | -- |
Example
curl -X POST http://localhost:8000/notifications/read-all \
-H "Authorization: Bearer $TOKEN"POST /notifications/{notification_id}/read
Mark Read
Mark a single notification as read.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
notification_id | path | yes | string | -- |
Responses
| Status | Description | Body |
|---|---|---|
204 | Successful Response | -- |
422 | Validation Error | HTTPValidationError |
Example
curl -X POST http://localhost:8000/notifications/:notification_id/read \
-H "Authorization: Bearer $TOKEN"