Skip to content
Chatto v0.5.0

AdminUserService

Chatto exposes this service below /api/connect.

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

Server-admin user management commands and member-detail reads.

Lists server members for the admin members screen. Requires admin.view-users.

POST /api/connect/chatto.admin.v1.AdminUserService/ListMembers

Request server-admin member IDs. Results use creation time, oldest first. Users without a creation time appear last, ordered by case-insensitive login. User IDs break ties.

FieldTypeDescription
searchstringCase-insensitive login/display-name search term. Empty disables search.
pagechatto.api.v1.PageRequestDefaults to 20 results when absent or limit is zero. Maximum: 100.

Ordered server-admin member IDs. Load rows and role summaries with BatchGetMembers. Advance the offset by the number of IDs, including IDs omitted by a later batch read.

FieldTypeDescription
pagechatto.api.v1.PageInfoPage metadata.
user_idsrepeated stringMatching member IDs in list order.

Gets one server member plus role/permission metadata for admin details. Requires admin.view-users. Returns NOT_FOUND when the user does not exist.

POST /api/connect/chatto.admin.v1.AdminUserService/GetMember

Request one server-admin member detail record.

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

Server-admin member detail payload.

FieldTypeDescription
memberAdminMemberMember record.
rolesrepeated AdminRoleRoles for assignment UI.
available_permissionsrepeated stringPermissions available for per-user overrides.
viewer_can_assign_rolesboolWhether the caller may assign/revoke roles.
viewer_can_manage_rolesboolWhether the caller may edit role definitions.
viewer_can_manage_user_permissionsboolWhether the caller may edit direct user permissions.
assignable_role_namesrepeated stringRoles the caller may assign without granting authority the caller does not possess. Populated when assignment limits are enforced.
revocable_role_namesrepeated stringRoles the caller may revoke without removing restrictions or authority beyond the caller’s own. Populated when assignment limits are enforced.
role_assignment_limits_enforcedboolTrue when assignable_role_names and revocable_role_names are authoritative. Older servers leave this false and clients may retain legacy behaviour.

Gets server member rows for multiple users. Requires admin.view-users.

POST /api/connect/chatto.admin.v1.AdminUserService/BatchGetMembers

Request server-admin member rows for a set of stable user IDs.

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

Batch server-admin member response.

FieldTypeDescription
membersrepeated AdminMemberFound members. The server preserves first-seen request order and de-duplicates repeated IDs.
rolesrepeated chatto.api.v1.RolePublic roles for display-name lookup.

Gets explicit roles and current assignment limits for one human user. Requires role.assign, with privileged mode active for human sessions; admin.view-users is not required. Returns NOT_FOUND for an unknown or deleted user, and FAILED_PRECONDITION for a bot account.

POST /api/connect/chatto.admin.v1.AdminUserService/GetUserRoleAssignments

Request role assignments without administrative account details.

FieldTypeDescription
user_idstringRequired stable ID of a human user.

Current role assignments and limits for the requested user.

FieldTypeDescription
assignmentsUserRoleAssignmentsRequested assignment state. Resolve role metadata with RoleService.

Assigns a role to a user. Requires role.assign, and non-owner callers may only assign roles whose granted authority they already possess.

POST /api/connect/chatto.admin.v1.AdminUserService/AssignRole

Request to assign a role to a user.

FieldTypeDescription
user_idstringTarget user ID.
role_namestringRole name to assign.

Result of assigning a role.

FieldTypeDescription
memberAdminMemberUpdated admin member row.

Revokes a role from a user. Requires role.assign, and non-owner callers may only revoke roles whose permission decisions are within their authority.

POST /api/connect/chatto.admin.v1.AdminUserService/RevokeRole

Request to revoke a role from a user.

FieldTypeDescription
user_idstringTarget user ID.
role_namestringRole name to revoke.

Result of revoking a role.

FieldTypeDescription
memberAdminMemberUpdated admin member row.

Updates another user’s password as an admin action. Requires user.manage-accounts and a fresh credential for the caller; the caller cannot target their own account.

POST /api/connect/chatto.admin.v1.AdminUserService/ChangeUserPassword

Request to update a user’s password as a server-admin action.

FieldTypeDescription
user_idstringTarget user ID.
passwordstringNew password. The server applies the same password policy as registration and password reset.

Result of an admin password update.

FieldTypeDescription
memberAdminMemberUpdated admin member row.

Clears the target user’s self-service username-change cooldown. Requires user.manage-accounts, including when the caller targets their own account.

POST /api/connect/chatto.admin.v1.AdminUserService/ClearUsernameCooldown

Request to clear a user’s self-service username-change cooldown.

FieldTypeDescription
user_idstringTarget user ID.

Result of clearing a user’s username-change cooldown.

Deletes a user account as an admin action. Requires user.delete-any for other users or user.delete-self for the caller.

POST /api/connect/chatto.admin.v1.AdminUserService/DeleteUser

Request to delete a user account as a server-admin action.

FieldTypeDescription
user_idstringTarget user ID.

Result of deleting a user account.

Deactivates or reactivates a human account. Requires user.manage-accounts. The caller cannot target their own account or an owner account. Deactivation immediately invalidates existing sessions and prevents sign-in. Reactivation permits new sign-ins; old sessions remain invalid. Repeating the current state succeeds without changing it.

POST /api/connect/chatto.admin.v1.AdminUserService/SetUserDeactivated

Set account access without deleting user data.

FieldTypeDescription
user_idstringNo field description provided.
deactivatedboolNo field description provided.

No message description provided.

FieldTypeDescription
memberAdminMemberUpdated administrative member record.