Skip to content
Chatto v0.5.0

NotificationPolicyService

Chatto exposes this service below /api/connect.

Shared message and enum definitions are documented in Shared Types And Enums.

Reads and updates the authenticated viewer’s server, room-group, and room notification delivery policies.

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/GetNotificationPolicy

Input: NotificationPolicyServiceGetNotificationPolicyRequest

Section titled “Input: NotificationPolicyServiceGetNotificationPolicyRequest”

Request one notification policy for the authenticated viewer.

FieldTypeDescription
scopeNotificationPolicyScopeRequired policy scope.

Result: NotificationPolicyServiceGetNotificationPolicyResponse

Section titled “Result: NotificationPolicyServiceGetNotificationPolicyResponse”

One resolved notification policy.

FieldTypeDescription
policyScopedNotificationPolicyRequested policy and its explicit scope.

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/BatchGetNotificationPolicies

Input: BatchGetNotificationPoliciesRequest

Section titled “Input: BatchGetNotificationPoliciesRequest”

Request an explicit bounded set of notification policies.

FieldTypeDescription
scopesrepeated NotificationPolicyScopeRequired 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.

FieldTypeDescription
policiesrepeated ScopedNotificationPolicyFound policies in first-seen request order.

Atomically sets or clears selected overrides at one explicit scope.

POST /api/connect/chatto.api.v1.NotificationPolicyService/UpdateNotificationPolicy

Input: NotificationPolicyServiceUpdateNotificationPolicyRequest

Section titled “Input: NotificationPolicyServiceUpdateNotificationPolicyRequest”

Sparsely update notification policy overrides at one explicit scope.

FieldTypeDescription
scopeNotificationPolicyScopeRequired policy scope.
overridesNotificationDeliveryModesSparse override values. Fields selected by update_mask but absent here are cleared to Inherit.
update_maskgoogle.protobuf.FieldMaskFields 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.

FieldTypeDescription
policyScopedNotificationPolicyUpdated policy and its explicit scope.