Skip to content

UserService

Chatto exposes this service below /api/connect.

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

Reads the authenticated server-wide user directory.

Lists users visible to the authenticated user. Admin-sensitive account fields stay out of this public row shape.

POST /api/connect/chatto.api.v1.UserService/ListUsers

Request for users visible to the authenticated user.

FieldTypeDescription
searchstringOptional case-insensitive search against login and display name.
pagePageRequestPage request. Defaults to 20 results when absent or limit is zero.

User directory page.

FieldTypeDescription
usersrepeated DirectoryMemberUsers in the requested page.
pagePageInfoPage metadata.

Gets one visible user by user ID or login. Returns NOT_FOUND when the target is unknown.

POST /api/connect/chatto.api.v1.UserService/GetUser

Request one visible user by stable user ID or login.

FieldTypeDescription
target.user_idstringTarget stable user ID.
target.loginstringTarget login identifier.

User directory response.

FieldTypeDescription
userDirectoryMemberRequested user.

Gets visible user rows for multiple stable user IDs. Unknown IDs are omitted from the response.

POST /api/connect/chatto.api.v1.UserService/BatchGetUsers

Request user directory rows for a set of stable user IDs.

FieldTypeDescription
user_idsrepeated stringRequired target user IDs. Unknown IDs are omitted from the response.

Batch user directory response.

FieldTypeDescription
usersrepeated DirectoryMemberFound users. The server preserves first-seen request order and de-duplicates repeated IDs.