NotificationPreferencesService
Chatto exposes this service below /api/connect.
Shared message and enum definitions are documented in Shared Types And Enums.
NotificationPreferencesService
Section titled “NotificationPreferencesService”Reads and updates per-room notification preferences for the current user.
GetServerNotificationPreference
Section titled “GetServerNotificationPreference”Returns the current user’s explicit and effective server notification level.
POST /api/connect/chatto.api.v1.NotificationPreferencesService/GetServerNotificationPreferenceInput: GetServerNotificationPreferenceRequest
Section titled “Input: GetServerNotificationPreferenceRequest”Request for the current user’s server-level notification preference.
Result: GetNotificationPreferenceResponse
Section titled “Result: GetNotificationPreferenceResponse”Current notification preference.
| Field | Type | Description |
|---|---|---|
preference | NotificationPreference | Current stored and effective notification preference. |
UpdateServerNotificationPreference
Section titled “UpdateServerNotificationPreference”Updates the current user’s explicit server notification level and returns the resulting stored and effective levels.
POST /api/connect/chatto.api.v1.NotificationPreferencesService/UpdateServerNotificationPreferenceInput: UpdateServerNotificationPreferenceRequest
Section titled “Input: UpdateServerNotificationPreferenceRequest”Request to update the current user’s server-level notification level.
| Field | Type | Description |
|---|---|---|
level | NotificationLevel | Required. New explicit notification level. Use NOTIFICATION_LEVEL_DEFAULT to return the server to default behavior. |
Result: UpdateNotificationPreferenceResponse
Section titled “Result: UpdateNotificationPreferenceResponse”Updated notification preference.
| Field | Type | Description |
|---|---|---|
preference | NotificationPreference | Stored and effective notification preference after the update. |
GetRoomNotificationPreference
Section titled “GetRoomNotificationPreference”Returns the current user’s explicit and effective notification level for a room. Use this before rendering room notification controls so the UI can distinguish inherited defaults from an explicit room override. Returns NOT_FOUND when the room does not exist and PERMISSION_DENIED when the room exists but is inaccessible to the caller.
POST /api/connect/chatto.api.v1.NotificationPreferencesService/GetRoomNotificationPreferenceInput: GetRoomNotificationPreferenceRequest
Section titled “Input: GetRoomNotificationPreferenceRequest”Request for the current user’s notification preference in one room.
| Field | Type | Description |
|---|---|---|
room_id | string | Required. Room whose notification preference should be loaded for the current user. |
Uses the same result shape documented above.
UpdateRoomNotificationPreference
Section titled “UpdateRoomNotificationPreference”Updates the current user’s explicit notification level for a room and returns the resulting stored and effective levels.
POST /api/connect/chatto.api.v1.NotificationPreferencesService/UpdateRoomNotificationPreferenceInput: UpdateRoomNotificationPreferenceRequest
Section titled “Input: UpdateRoomNotificationPreferenceRequest”Request to update the current user’s notification level in one room.
| Field | Type | Description |
|---|---|---|
room_id | string | Required. Room whose notification level should be changed for the current user. |
level | NotificationLevel | Required. New explicit notification level. Use NOTIFICATION_LEVEL_DEFAULT to return the room to inherited/default behavior. |
Result: UpdateNotificationPreferenceResponse
Section titled “Result: UpdateNotificationPreferenceResponse”Uses the same result shape documented above.