UserService
Chatto exposes this service below /api/connect.
Shared message and enum definitions are documented in Shared Types And Enums.
UserService
Section titled “UserService”Reads the authenticated server-wide user directory.
ListUsers
Section titled “ListUsers”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/ListUsersInput: ListUsersRequest
Section titled “Input: ListUsersRequest”Request for users visible to the authenticated user.
| Field | Type | Description |
|---|---|---|
search | string | Optional case-insensitive search against login and display name. |
page | PageRequest | Page request. Defaults to 20 results when absent or limit is zero. |
Result: ListUsersResponse
Section titled “Result: ListUsersResponse”User directory page.
| Field | Type | Description |
|---|---|---|
users | repeated DirectoryMember | Users in the requested page. |
page | PageInfo | Page metadata. |
GetUser
Section titled “GetUser”Gets one visible user by user ID or login. Returns NOT_FOUND when the target is unknown.
POST /api/connect/chatto.api.v1.UserService/GetUserInput: GetUserRequest
Section titled “Input: GetUserRequest”Request one visible user by stable user ID or login.
| Field | Type | Description |
|---|---|---|
target.user_id | string | Target stable user ID. |
target.login | string | Target login identifier. |
Result: GetUserResponse
Section titled “Result: GetUserResponse”User directory response.
| Field | Type | Description |
|---|---|---|
user | DirectoryMember | Requested user. |
BatchGetUsers
Section titled “BatchGetUsers”Gets visible user rows for multiple stable user IDs. Unknown IDs are omitted from the response.
POST /api/connect/chatto.api.v1.UserService/BatchGetUsersInput: BatchGetUsersRequest
Section titled “Input: BatchGetUsersRequest”Request user directory rows for a set of stable user IDs.
| Field | Type | Description |
|---|---|---|
user_ids | repeated string | Required target user IDs. Unknown IDs are omitted from the response. |
Result: BatchGetUsersResponse
Section titled “Result: BatchGetUsersResponse”Batch user directory response.
| Field | Type | Description |
|---|---|---|
users | repeated DirectoryMember | Found users. The server preserves first-seen request order and de-duplicates repeated IDs. |