AdminServerService

Chatto exposes this service below /api/connect.

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

AdminServerService

Provides server-administration commands for profile, branding, and security settings.

GetServerConfig

Gets runtime-editable server profile settings. This RPC requires server.manage.

POST /api/connect/chatto.admin.v1.AdminServerService/GetServerConfig

Input: GetServerConfigRequest

Request server profile settings.

Result: GetServerConfigResponse

Server profile settings plus effective public branding.

Field	Type	Description
config	ServerConfig	Runtime-editable server profile settings.
public_profile	chatto.api.v1.ServerPublicProfile	Effective public server profile and branding.

UpdateServerConfig

Updates runtime-editable server profile settings. This RPC requires server.manage.

POST /api/connect/chatto.admin.v1.AdminServerService/UpdateServerConfig

Input: UpdateServerConfigRequest

Request to update runtime-editable server profile settings.

Field	Type	Description
server_name	optional string	Optional server name for page titles. Set to empty string to use default.
description	optional string	Optional short server description for OG link-preview metadata. Set to empty string to clear.
motd	optional string	Optional message of the day for the header. Set to empty string to clear.
welcome_message	optional string	Optional welcome message shown on the login page. Set to empty string to clear.

Result: UpdateServerConfigResponse

Result of updating runtime-editable server profile settings.

Field	Type	Description
public_profile	chatto.api.v1.ServerPublicProfile	Updated public server profile and branding.
config	ServerConfig	Updated runtime-editable server profile settings.

UploadServerLogo

Uploads and sets the public server logo. This RPC requires server.manage.

POST /api/connect/chatto.admin.v1.AdminServerService/UploadServerLogo

Input: UploadServerLogoRequest

Request to upload and set the public server logo.

Field	Type	Description
image	chatto.api.v1.ImageUpload	Image payload. The server validates, resizes, and stores a WebP logo.

Result: UploadServerLogoResponse

Result of uploading the public server logo.

Field	Type	Description
public_profile	chatto.api.v1.ServerPublicProfile	Updated public server profile and branding.

DeleteServerLogo

Clears the public server logo. This RPC requires server.manage.

POST /api/connect/chatto.admin.v1.AdminServerService/DeleteServerLogo

Input: DeleteServerLogoRequest

Request to clear the public server logo.

Result: DeleteServerLogoResponse

Result of clearing the public server logo.

Field	Type	Description
public_profile	chatto.api.v1.ServerPublicProfile	Updated public server profile and branding.

UploadServerBanner

Uploads and sets the public server banner. This RPC requires server.manage.

POST /api/connect/chatto.admin.v1.AdminServerService/UploadServerBanner

Input: UploadServerBannerRequest

Request to upload and set the public server banner.

Field	Type	Description
image	chatto.api.v1.ImageUpload	Image payload. The server validates, resizes, and stores a WebP banner.

Result: UploadServerBannerResponse

Result of uploading the public server banner.

Field	Type	Description
public_profile	chatto.api.v1.ServerPublicProfile	Updated public server profile and branding.

DeleteServerBanner

Clears the public server banner. This RPC requires server.manage.

POST /api/connect/chatto.admin.v1.AdminServerService/DeleteServerBanner

Input: DeleteServerBannerRequest

Request to clear the public server banner.

Result: DeleteServerBannerResponse

Result of clearing the public server banner.

Field	Type	Description
public_profile	chatto.api.v1.ServerPublicProfile	Updated public server profile and branding.

GetServerSecurityConfig

Returns security-sensitive server configuration. This RPC requires server.manage.

POST /api/connect/chatto.admin.v1.AdminServerService/GetServerSecurityConfig

Input: GetServerSecurityConfigRequest

Request for server security configuration.

Result: GetServerSecurityConfigResponse

Security-sensitive server configuration. The caller must be allowed to manage server configuration.

Field	Type	Description
blocked_usernames	repeated string	Blocked usernames. Entries are normalized by the server.

UpdateBlockedUsernames

Updates the blocked-username list. This RPC requires server.manage.

POST /api/connect/chatto.admin.v1.AdminServerService/UpdateBlockedUsernames

Input: UpdateBlockedUsernamesRequest

Request to update the server blocked-username list.

Field	Type	Description
blocked_usernames	repeated string	Blocked usernames. Empty entries are ignored and entries are normalized by the server.

Result: UpdateBlockedUsernamesResponse

Result of updating the server blocked-username list.

Field	Type	Description
blocked_usernames	repeated string	Effective blocked usernames after the update.