NotificationService
Chatto exposes this service below /api/connect.
Shared message and enum definitions are documented in Shared Types And Enums.
NotificationService
Section titled “NotificationService”Reads, marks read, and deletes notifications for the authenticated viewer.
GetNotificationOccurrence
Section titled “GetNotificationOccurrence”Gets one exact visible occurrence. Message-derived occurrences require current room membership. Occurrences also require message.read or a matching thread relationship with message.read-interactions. Returns NOT_FOUND when the occurrence is absent, deleted, expired, or no longer visible to the authenticated viewer. Returns UNIMPLEMENTED when this server cannot validate its signal kind.
POST /api/connect/chatto.api.v1.NotificationService/GetNotificationOccurrenceInput: GetNotificationOccurrenceRequest
Section titled “Input: GetNotificationOccurrenceRequest”Request one exact notification occurrence by stable ID.
| Field | Type | Description |
|---|---|---|
notification_id | string | Required stable occurrence ID. |
Result: GetNotificationOccurrenceResponse
Section titled “Result: GetNotificationOccurrenceResponse”One exact notification occurrence.
| Field | Type | Description |
|---|---|---|
occurrence | NotificationOccurrence | Visible occurrence. Absence is reported as NOT_FOUND. |
BatchGetNotificationOccurrences
Section titled “BatchGetNotificationOccurrences”Gets an explicit bounded set of visible occurrences. Missing or inaccessible IDs are omitted and duplicate IDs are de-duplicated. Returns UNIMPLEMENTED rather than partially answering when this server cannot validate one requested signal kind.
POST /api/connect/chatto.api.v1.NotificationService/BatchGetNotificationOccurrencesInput: BatchGetNotificationOccurrencesRequest
Section titled “Input: BatchGetNotificationOccurrencesRequest”Request an explicit bounded set of notification occurrences.
| Field | Type | Description |
|---|---|---|
notification_ids | repeated string | Stable occurrence IDs. Unknown, deleted, and currently invisible IDs are omitted. Repeated IDs are de-duplicated in first-seen request order. |
Result: BatchGetNotificationOccurrencesResponse
Section titled “Result: BatchGetNotificationOccurrencesResponse”Exact visible notification occurrences requested by stable ID.
| Field | Type | Description |
|---|---|---|
occurrences | repeated NotificationOccurrence | Found occurrences in first-seen request order. |
ListNotificationOccurrences
Section titled “ListNotificationOccurrences”Lists exact Notifications 2.0 occurrences. Clients may derive temporary presentation groups without changing occurrence identity or counts. Message-derived occurrences require current room membership. Occurrences also require message.read or a matching thread relationship with message.read-interactions. Returns UNIMPLEMENTED rather than silently omitting an occurrence whose signal kind this server version cannot validate and assemble.
POST /api/connect/chatto.api.v1.NotificationService/ListNotificationOccurrencesInput: ListNotificationOccurrencesRequest
Section titled “Input: ListNotificationOccurrencesRequest”Request for one page of notification occurrences.
| Field | Type | Description |
|---|---|---|
page | PageRequest | Defaults to 50 results when absent or limit is zero. Maximum: 100. |
Result: ListNotificationOccurrencesResponse
Section titled “Result: ListNotificationOccurrencesResponse”One page of exact notification occurrences.
| Field | Type | Description |
|---|---|---|
occurrences | repeated NotificationOccurrence | Occurrences newest activity first. |
page | PageInfo | Page metadata. |
unread_count | int32 | Total unread occurrence count, independent of presentation grouping. |
next_expiry_at | google.protobuf.Timestamp | Earliest expiry in the complete list, including occurrences outside this page. Clients refresh authoritative notification state at this boundary. |
room_unread_counts | repeated NotificationRoomUnreadCount | Complete unread-occurrence counts by target room. This is independent of the bounded page so room indicators remain authoritative. |
important_unread_count | int32 | Exact unread occurrences with Important attention. |
MarkNotificationRead
Section titled “MarkNotificationRead”Marks one occurrence read. Repeating the call is safe. Returns UNIMPLEMENTED when this server cannot validate the occurrence signal kind.
POST /api/connect/chatto.api.v1.NotificationService/MarkNotificationReadInput: MarkNotificationReadRequest
Section titled “Input: MarkNotificationReadRequest”Request to mark one notification occurrence read.
| Field | Type | Description |
|---|---|---|
notification_id | string | Required stable occurrence ID. |
Result: MarkNotificationReadResponse
Section titled “Result: MarkNotificationReadResponse”Notification occurrence after marking it read.
| Field | Type | Description |
|---|---|---|
occurrence | NotificationOccurrence | Updated occurrence. |
DeleteNotificationOccurrence
Section titled “DeleteNotificationOccurrence”Permanently deletes one occurrence while retaining its anti-recreation tombstone through the original expiry. Repeating the call is safe. Returns UNIMPLEMENTED when this server cannot validate the occurrence signal kind.
POST /api/connect/chatto.api.v1.NotificationService/DeleteNotificationOccurrenceInput: DeleteNotificationOccurrenceRequest
Section titled “Input: DeleteNotificationOccurrenceRequest”Request permanent deletion of one notification occurrence.
| Field | Type | Description |
|---|---|---|
notification_id | string | Required stable occurrence ID. |
Result: DeleteNotificationOccurrenceResponse
Section titled “Result: DeleteNotificationOccurrenceResponse”Result of deleting one notification occurrence.
| Field | Type | Description |
|---|---|---|
deleted | bool | True when this call replaced a visible occurrence with a deletion tombstone. False when the occurrence was already absent or deleted. |
BatchDeleteNotificationOccurrences
Section titled “BatchDeleteNotificationOccurrences”Permanently deletes an exact set of occurrences. Repeating the call is safe because later activity receives different occurrence IDs. Returns UNIMPLEMENTED rather than partially deleting a signal kind this server cannot validate.
POST /api/connect/chatto.api.v1.NotificationService/BatchDeleteNotificationOccurrencesInput: BatchDeleteNotificationOccurrencesRequest
Section titled “Input: BatchDeleteNotificationOccurrencesRequest”Request permanent deletion of an explicit bounded set of occurrences.
| Field | Type | Description |
|---|---|---|
notification_ids | repeated string | Stable occurrence IDs to delete. Duplicates and already absent IDs are ignored. The server accepts at most 100 IDs. |
Result: BatchDeleteNotificationOccurrencesResponse
Section titled “Result: BatchDeleteNotificationOccurrencesResponse”Result of deleting exact notification occurrences.
| Field | Type | Description |
|---|---|---|
deleted_count | int32 | Number of visible occurrences replaced by deletion tombstones. |
DeleteAllNotificationOccurrences
Section titled “DeleteAllNotificationOccurrences”Permanently deletes every visible occurrence current at the server’s authoritative mutation boundary. Callers must not retry this mutation automatically because later activity may arrive after that boundary. Returns UNIMPLEMENTED rather than partially deleting a signal kind this server cannot validate.
POST /api/connect/chatto.api.v1.NotificationService/DeleteAllNotificationOccurrencesInput: DeleteAllNotificationOccurrencesRequest
Section titled “Input: DeleteAllNotificationOccurrencesRequest”Request permanent deletion of every currently visible notification occurrence.
Result: DeleteAllNotificationOccurrencesResponse
Section titled “Result: DeleteAllNotificationOccurrencesResponse”Result of deleting every currently visible notification occurrence.
| Field | Type | Description |
|---|---|---|
deleted_count | int32 | Number of visible occurrences replaced by deletion tombstones. |