ScalixScalix Docs
Sign up

Notifications API

REST API endpoints for Notifications.

REST API endpoints for Notifications. 10 operations.

List notifications

plaintext
GET /v1/notifications

Requires the notifications:read scope.

Auth: Bearer API key

Responses

StatusDescription
200List notifications
401Missing or invalid API key
403Missing notifications:read scope
500Internal error

operationId: listNotifications

Send a notification

plaintext
POST /v1/notifications

Requires the notifications:write scope.

Auth: Bearer API key

Responses

StatusDescription
200Send a notification
401Missing or invalid API key
403Missing notifications:write scope
500Internal error

operationId: sendNotification

Get a notification

plaintext
GET /v1/notifications/{id}

Requires the notifications:read scope.

Auth: Bearer API key

Responses

StatusDescription
200Get a notification
401Missing or invalid API key
403Missing notifications:read scope
500Internal error

operationId: getNotification

Mark a notification read

plaintext
POST /v1/notifications/{id}/read

Requires the notifications:write scope.

Auth: Bearer API key

Responses

StatusDescription
200Mark a notification read
401Missing or invalid API key
403Missing notifications:write scope
500Internal error

operationId: markNotificationRead

Register a notification device

plaintext
POST /v1/notifications/devices

Requires the notifications:write scope.

Auth: Bearer API key

Responses

StatusDescription
200Register a notification device
401Missing or invalid API key
403Missing notifications:write scope
500Internal error

operationId: registerNotificationDevice

Unregister a notification device

plaintext
DELETE /v1/notifications/devices/{device_id}

Requires the notifications:write scope.

Auth: Bearer API key

Responses

StatusDescription
200Unregister a notification device
401Missing or invalid API key
403Missing notifications:write scope
500Internal error

operationId: unregisterNotificationDevice

Get notification preferences

plaintext
GET /v1/notifications/preferences

Requires the notifications:read scope.

Auth: Bearer API key

Responses

StatusDescription
200Get notification preferences
401Missing or invalid API key
403Missing notifications:read scope
500Internal error

operationId: getNotificationPreferences

Update notification preferences

plaintext
PUT /v1/notifications/preferences

Requires the notifications:write scope.

Auth: Bearer API key

Responses

StatusDescription
200Update notification preferences
401Missing or invalid API key
403Missing notifications:write scope
500Internal error

operationId: updateNotificationPreferences

Mark all notifications read

plaintext
POST /v1/notifications/read-all

Requires the notifications:write scope.

Auth: Bearer API key

Responses

StatusDescription
200Mark all notifications read
401Missing or invalid API key
403Missing notifications:write scope
500Internal error

operationId: markAllNotificationsRead

Unread notification count

plaintext
GET /v1/notifications/unread-count

Requires the notifications:read scope.

Auth: Bearer API key

Responses

StatusDescription
200Unread notification count
401Missing or invalid API key
403Missing notifications:read scope
500Internal error

operationId: getUnreadCount