Skip to content
Chatto v0.5.0

ServerDiscoveryService

Chatto exposes this service below /api/connect.

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

Provides unauthenticated server discovery metadata.

Returns public server metadata, branding, registration status, and login provider information. This fully public RPC is available before login so clients can render the first server screen and authentication choices.

POST /api/connect/chatto.discovery.v1.ServerDiscoveryService/GetServer

Request for public server metadata.

Public metadata clients need before they can authenticate or render the initial server view.

FieldTypeDescription
profilechatto.api.v1.ServerPublicProfilePublic server profile and branding.
loginchatto.api.v1.ServerLoginLogin and registration options.
setup_requiredboolWhether first-run setup is available before normal registration.

Lists product features without requiring a session. Clients may load this catalog on demand and cache it by server software version, locale, and version filter. Refresh when any of those values change. Older servers can return UNIMPLEMENTED; this does not prevent normal chat use.

POST /api/connect/chatto.discovery.v1.ServerDiscoveryService/ListFeatures

Optional filters for the public feature catalog.

FieldTypeDescription
localeoptional stringBCP 47 language tag for feature names and descriptions. The server tries this locale, its parents, then English. Invalid or unsupported locales, and omitted values, use English.
introduced_after_versionoptional stringReturn only features introduced strictly after this Chatto release. Omit for the complete catalog. Must be a full Semantic Version, including any prerelease stage; invalid or empty values are INVALID_ARGUMENT. Third-party clients should omit this filter and use stable feature IDs.

Advisory features supported by this server software, in display order. An empty list means no entries match, not that every feature is supported.

FieldTypeDescription
featuresrepeated ServerFeatureProduct metadata, not a complete API capability declaration.

Returns the public Neighbor directory without requiring a session.

POST /api/connect/chatto.discovery.v1.ServerDiscoveryService/ListNeighbors

Request for the public Neighbor directory.

Publicly advertised servers. The response has no ordering contract.

FieldTypeDescription
originsrepeated stringCanonical origins of the advertised servers.

Returns the Neighborhood without requiring a session. The server contacts other servers in the background and caches the result. A call does not contact other servers, so a client can show the Neighborhood without revealing the user’s network address to those servers. The server refreshes the Neighborhood at least once per hour and soon after its Neighbors change.

POST /api/connect/chatto.discovery.v1.ServerDiscoveryService/ListNeighborhoodServers

Request for the Neighborhood that this server has discovered.

Servers that the called server discovered through its Neighbors. The called server lists each of its Neighbors whose public profile loaded. It also lists servers that a mutually advertising Neighbor recommends when the recommendation is also mutual. The response has no ordering contract.

FieldTypeDescription
serversrepeated NeighborhoodServerServers in the Neighborhood.
refreshed_atgoogle.protobuf.TimestampTime when the called server last completed Neighborhood discovery. Absent before the first completed discovery.