Notifications API
REST API endpoints for Notifications.
REST API endpoints for Notifications. 10 operations.
List notifications
GET /v1/notificationsRequires the notifications:read scope.
Auth: Bearer API key
Responses
| Status | Description |
|---|---|
200 | List notifications |
401 | Missing or invalid API key |
403 | Missing notifications:read scope |
500 | Internal error |
operationId: listNotifications
Send a notification
POST /v1/notificationsRequires the notifications:write scope.
Auth: Bearer API key
Responses
| Status | Description |
|---|---|
200 | Send a notification |
401 | Missing or invalid API key |
403 | Missing notifications:write scope |
500 | Internal error |
operationId: sendNotification
Get a notification
GET /v1/notifications/{id}Requires the notifications:read scope.
Auth: Bearer API key
Responses
| Status | Description |
|---|---|
200 | Get a notification |
401 | Missing or invalid API key |
403 | Missing notifications:read scope |
500 | Internal error |
operationId: getNotification
Mark a notification read
POST /v1/notifications/{id}/readRequires the notifications:write scope.
Auth: Bearer API key
Responses
| Status | Description |
|---|---|
200 | Mark a notification read |
401 | Missing or invalid API key |
403 | Missing notifications:write scope |
500 | Internal error |
operationId: markNotificationRead
Register a notification device
POST /v1/notifications/devicesRequires the notifications:write scope.
Auth: Bearer API key
Responses
| Status | Description |
|---|---|
200 | Register a notification device |
401 | Missing or invalid API key |
403 | Missing notifications:write scope |
500 | Internal error |
operationId: registerNotificationDevice
Unregister a notification device
DELETE /v1/notifications/devices/{device_id}Requires the notifications:write scope.
Auth: Bearer API key
Responses
| Status | Description |
|---|---|
200 | Unregister a notification device |
401 | Missing or invalid API key |
403 | Missing notifications:write scope |
500 | Internal error |
operationId: unregisterNotificationDevice
Get notification preferences
GET /v1/notifications/preferencesRequires the notifications:read scope.
Auth: Bearer API key
Responses
| Status | Description |
|---|---|
200 | Get notification preferences |
401 | Missing or invalid API key |
403 | Missing notifications:read scope |
500 | Internal error |
operationId: getNotificationPreferences
Update notification preferences
PUT /v1/notifications/preferencesRequires the notifications:write scope.
Auth: Bearer API key
Responses
| Status | Description |
|---|---|
200 | Update notification preferences |
401 | Missing or invalid API key |
403 | Missing notifications:write scope |
500 | Internal error |
operationId: updateNotificationPreferences
Mark all notifications read
POST /v1/notifications/read-allRequires the notifications:write scope.
Auth: Bearer API key
Responses
| Status | Description |
|---|---|
200 | Mark all notifications read |
401 | Missing or invalid API key |
403 | Missing notifications:write scope |
500 | Internal error |
operationId: markAllNotificationsRead
Unread notification count
GET /v1/notifications/unread-countRequires the notifications:read scope.
Auth: Bearer API key
Responses
| Status | Description |
|---|---|
200 | Unread notification count |
401 | Missing or invalid API key |
403 | Missing notifications:read scope |
500 | Internal error |
operationId: getUnreadCount