Skip to content
Chatto v0.5.0

AdminServerService

Chatto exposes this service below /api/connect.

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

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

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

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

Request runtime-editable server settings; requires server.manage.

Server settings plus effective public branding.

FieldTypeDescription
configServerConfigRuntime-editable server settings.
public_profilechatto.api.v1.ServerPublicProfileEffective public server profile and branding.

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

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

Request to update runtime-editable server settings; requires server.manage.

FieldTypeDescription
server_nameoptional stringOptional server name for page titles. Set to empty string to use default.
descriptionoptional stringOptional short server description for OG link-preview metadata. Set to empty string to clear.
motdoptional stringOptional message of the day for the header. Set to empty string to clear.
welcome_messageoptional stringOptional welcome message shown on the login page. Set to empty string to clear.
registrationRegistrationSettingsUpdatePartial account creation settings; requires server.manage.
update_maskgoogle.protobuf.FieldMaskEditable fields to apply or reset: server_name, description, motd, welcome_message, registration.admission. Omit to infer populated fields; * selects all editable fields. An explicit empty mask is invalid. Unselected values are ignored. Selected absent values reset the field to its default, subject to field validation.

Result of updating runtime-editable server settings.

FieldTypeDescription
public_profilechatto.api.v1.ServerPublicProfileUpdated public server profile and branding.
configServerConfigUpdated runtime-editable server settings.

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

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

Request to upload and set the public server logo.

FieldTypeDescription
imagechatto.api.v1.ImageUploadImage payload. The server validates, resizes, and stores a WebP logo.

Result of uploading the public server logo.

FieldTypeDescription
public_profilechatto.api.v1.ServerPublicProfileUpdated public server profile and branding.

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

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

Request to clear the public server logo.

Result of clearing the public server logo.

FieldTypeDescription
public_profilechatto.api.v1.ServerPublicProfileUpdated public server profile and branding.

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

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

Request to upload and set the public server banner.

FieldTypeDescription
imagechatto.api.v1.ImageUploadImage payload. The server validates, resizes, and stores a WebP banner.

Result of uploading the public server banner.

FieldTypeDescription
public_profilechatto.api.v1.ServerPublicProfileUpdated public server profile and branding.

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

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

Request to clear the public server banner.

Result of clearing the public server banner.

FieldTypeDescription
public_profilechatto.api.v1.ServerPublicProfileUpdated public server profile and branding.

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

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

Request for server security configuration.

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

FieldTypeDescription
blocked_usernamesrepeated stringBlocked usernames. Entries are normalized by the server.

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

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

Request to update the server blocked-username list.

FieldTypeDescription
blocked_usernamesrepeated stringComplete replacement list. Select blocked_usernames in update_mask and omit this field or send [] to clear the list. Empty entries are ignored and entries are normalized by the server.
update_maskgoogle.protobuf.FieldMaskEditable fields to apply or reset: blocked_usernames. Omit to infer populated fields; * selects all editable fields. An explicit empty mask is invalid. Unselected values are ignored. Selected absent values reset the field to its default, subject to field validation.

Result of updating the server blocked-username list.

FieldTypeDescription
blocked_usernamesrepeated stringEffective blocked usernames after the update.

Lists configured Neighbors. This RPC requires server.manage-neighbors.

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

Request to list configured Neighbors.

Configured Neighbors. The response has no ordering contract.

FieldTypeDescription
neighborsrepeated NeighborNo field description provided.

Gets one configured Neighbor. This RPC requires server.manage-neighbors.

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

Request for one configured Neighbor.

FieldTypeDescription
neighbor_idstringNo field description provided.

One configured Neighbor.

FieldTypeDescription
neighborNeighborNo field description provided.

Advertises one server origin. The origin must not identify this server. This RPC requires server.manage-neighbors.

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

Request to advertise one server origin.

FieldTypeDescription
originstringNo field description provided.

Newly configured Neighbor.

FieldTypeDescription
neighborNeighborNo field description provided.

Changes one advertised server origin. The new origin must not identify this server. This RPC requires server.manage-neighbors.

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

Request to change one advertised server origin.

FieldTypeDescription
neighbor_idstringNo field description provided.
originstringNo field description provided.
revisionstringNo field description provided.
update_maskgoogle.protobuf.FieldMaskEditable fields to apply or reset: origin. Omit to infer populated fields; * selects all editable fields. An explicit empty mask is invalid. Unselected values are ignored. Selected absent values reset the field to its default, subject to field validation.

Updated Neighbor.

FieldTypeDescription
neighborNeighborNo field description provided.

Stops advertising one server origin. This RPC requires server.manage-neighbors.

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

Request to stop advertising one server origin.

FieldTypeDescription
neighbor_idstringNo field description provided.
revisionstringNo field description provided.

Empty result after a Neighbor is deleted.