Skip to content
Chatto v0.5.0

ViewerService

Chatto exposes this service below /api/connect.

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

Provides authenticated user profile, preferences, and capability state.

Returns the current authenticated viewer. This RPC requires a logged-in user; unauthenticated callers receive an UNAUTHENTICATED error.

POST /api/connect/chatto.api.v1.ViewerService/GetViewer

Request for the authenticated viewer snapshot.

Authenticated viewer snapshot needed by application shells.

FieldTypeDescription
userViewerUserCurrent authenticated user.
capabilitiesViewerCapabilitiesPermission-derived capabilities.
viewer_permissionsServerViewerPermissionsEffective server/channel permission decisions for the authenticated user.
viewer_stateServerViewerStateNon-permission server state for the authenticated user.
privileged_modePrivilegedModeStateExplicit privilege activation state for this authenticated session.

Activates elevation-required permissions for a fixed, non-sliding window. Returns FAILED_PRECONDITION when the caller is a bot or has no eligible permission entitlement.

POST /api/connect/chatto.api.v1.ViewerService/ActivatePrivilegedMode

Request to activate all currently entitled elevation-required permissions.

Result of activating privileged mode for the current session.

FieldTypeDescription
privileged_modePrivilegedModeStateCurrent privileged-mode state after activation.
capabilitiesViewerCapabilitiesPermission-derived capabilities that are effective after activation.
viewer_permissionsServerViewerPermissionsEffective server permission decisions after activation.

Deactivates elevation-required permissions immediately. Returns FAILED_PRECONDITION when the caller is a bot.

POST /api/connect/chatto.api.v1.ViewerService/DeactivatePrivilegedMode

Request to deactivate all elevation-required permissions for this session.

Result of deactivating privileged mode for the current session.

FieldTypeDescription
privileged_modePrivilegedModeStateCurrent privileged-mode state after deactivation.
capabilitiesViewerCapabilitiesPermission-derived capabilities that are effective after deactivation.
viewer_permissionsServerViewerPermissionsEffective server permission decisions after deactivation.