NotificationPolicyService
Chatto exposes this service below /api/connect.
Shared message and enum definitions are documented in Shared Types And Enums.
NotificationPolicyService
Section titled “NotificationPolicyService”Reads and updates the authenticated viewer’s server, room-group, and room notification delivery policies.
GetNotificationPolicy
Section titled “GetNotificationPolicy”Gets explicit and effective modes for one policy scope. Returns NOT_FOUND for a missing room group or room, and PERMISSION_DENIED when the viewer is not a current member of a requested room.
POST /api/connect/chatto.api.v1.NotificationPolicyService/GetNotificationPolicyInput: NotificationPolicyServiceGetNotificationPolicyRequest
Section titled “Input: NotificationPolicyServiceGetNotificationPolicyRequest”Request one notification policy for the authenticated viewer.
| Field | Type | Description |
|---|---|---|
scope | NotificationPolicyScope | Required policy scope. |
Result: NotificationPolicyServiceGetNotificationPolicyResponse
Section titled “Result: NotificationPolicyServiceGetNotificationPolicyResponse”One resolved notification policy.
| Field | Type | Description |
|---|---|---|
policy | ScopedNotificationPolicy | Requested policy and its explicit scope. |
BatchGetNotificationPolicies
Section titled “BatchGetNotificationPolicies”Gets an explicit bounded set of policies. Missing and inaccessible scopes are omitted, and duplicate scopes are de-duplicated in first-seen order.
POST /api/connect/chatto.api.v1.NotificationPolicyService/BatchGetNotificationPoliciesInput: BatchGetNotificationPoliciesRequest
Section titled “Input: BatchGetNotificationPoliciesRequest”Request an explicit bounded set of notification policies.
| Field | Type | Description |
|---|---|---|
scopes | repeated NotificationPolicyScope | Required scopes. Missing or inaccessible scopes are omitted. Repeated scopes are de-duplicated in first-seen request order. |
Result: BatchGetNotificationPoliciesResponse
Section titled “Result: BatchGetNotificationPoliciesResponse”Resolved notification policies requested by scope.
| Field | Type | Description |
|---|---|---|
policies | repeated ScopedNotificationPolicy | Found policies in first-seen request order. |
UpdateNotificationPolicy
Section titled “UpdateNotificationPolicy”Atomically sets or clears selected overrides at one explicit scope.
POST /api/connect/chatto.api.v1.NotificationPolicyService/UpdateNotificationPolicyInput: NotificationPolicyServiceUpdateNotificationPolicyRequest
Section titled “Input: NotificationPolicyServiceUpdateNotificationPolicyRequest”Sparsely update notification policy overrides at one explicit scope.
| Field | Type | Description |
|---|---|---|
scope | NotificationPolicyScope | Required policy scope. |
overrides | NotificationDeliveryModes | Sparse override values. Fields selected by update_mask but absent here are cleared to Inherit. |
update_mask | google.protobuf.FieldMask | Fields to set or clear, relative to overrides. Omit to infer populated overrides; * selects all supported fields. An explicit empty mask is invalid. Unselected override values are ignored. |
Result: NotificationPolicyServiceUpdateNotificationPolicyResponse
Section titled “Result: NotificationPolicyServiceUpdateNotificationPolicyResponse”Complete supported notification policy after a scoped sparse update.
| Field | Type | Description |
|---|---|---|
policy | ScopedNotificationPolicy | Updated policy and its explicit scope. |