ViewerService
Chatto exposes this service below /api/connect.
Shared message and enum definitions are documented in Shared Types And Enums.
ViewerService
Section titled “ViewerService”Provides authenticated user profile, preferences, and capability state.
GetViewer
Section titled “GetViewer”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/GetViewerInput: GetViewerRequest
Section titled “Input: GetViewerRequest”Request for the authenticated viewer snapshot.
Result: GetViewerResponse
Section titled “Result: GetViewerResponse”Authenticated viewer snapshot needed by application shells.
| Field | Type | Description |
|---|---|---|
user | ViewerUser | Current authenticated user. |
capabilities | ViewerCapabilities | Permission-derived capabilities. |
viewer_permissions | ServerViewerPermissions | Effective server/channel permission decisions for the authenticated user. |
viewer_state | ServerViewerState | Non-permission server state for the authenticated user. |
privileged_mode | PrivilegedModeState | Explicit privilege activation state for this authenticated session. |
ActivatePrivilegedMode
Section titled “ActivatePrivilegedMode”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/ActivatePrivilegedModeInput: ActivatePrivilegedModeRequest
Section titled “Input: ActivatePrivilegedModeRequest”Request to activate all currently entitled elevation-required permissions.
Result: ActivatePrivilegedModeResponse
Section titled “Result: ActivatePrivilegedModeResponse”Result of activating privileged mode for the current session.
| Field | Type | Description |
|---|---|---|
privileged_mode | PrivilegedModeState | Current privileged-mode state after activation. |
capabilities | ViewerCapabilities | Permission-derived capabilities that are effective after activation. |
viewer_permissions | ServerViewerPermissions | Effective server permission decisions after activation. |
DeactivatePrivilegedMode
Section titled “DeactivatePrivilegedMode”Deactivates elevation-required permissions immediately. Returns FAILED_PRECONDITION when the caller is a bot.
POST /api/connect/chatto.api.v1.ViewerService/DeactivatePrivilegedModeInput: DeactivatePrivilegedModeRequest
Section titled “Input: DeactivatePrivilegedModeRequest”Request to deactivate all elevation-required permissions for this session.
Result: DeactivatePrivilegedModeResponse
Section titled “Result: DeactivatePrivilegedModeResponse”Result of deactivating privileged mode for the current session.
| Field | Type | Description |
|---|---|---|
privileged_mode | PrivilegedModeState | Current privileged-mode state after deactivation. |
capabilities | ViewerCapabilities | Permission-derived capabilities that are effective after deactivation. |
viewer_permissions | ServerViewerPermissions | Effective server permission decisions after deactivation. |