RoomService
Chatto exposes this service below /api/connect.
Shared message and enum definitions are documented in Shared Types And Enums.
RoomService
Section titled “RoomService”Manages room-scoped operations for the current user.
RoomService owns operations whose authorization and state are primarily scoped to one room, including lifecycle, membership, moderation, room timeline reads, room read state, attachments, and live typing. Resource-specific services should still be preferred when an operation is not naturally room-scoped or when the resource needs an independent CRUD/batch surface.
GetNotice
Section titled “GetNotice”Reads a channel notice. Requires current room membership, including in archived rooms. A room without a notice returns an empty body.
POST /api/connect/chatto.api.v1.RoomService/GetNoticeInput: GetNoticeRequest
Section titled “Input: GetNoticeRequest”Reads the current channel notice, including its version when cleared.
| Field | Type | Description |
|---|---|---|
room_id | string | No field description provided. |
Result: GetNoticeResponse
Section titled “Result: GetNoticeResponse”No message description provided.
| Field | Type | Description |
|---|---|---|
notice | RoomNotice | No field description provided. |
PublishNotice
Section titled “PublishNotice”Publishes, corrects, or explicitly republishes a notice. Requires current membership and room.manage-notice. Archived rooms reject writes. A stale expected_version returns ABORTED; preserve the draft and reload before retry.
POST /api/connect/chatto.api.v1.RoomService/PublishNoticeInput: PublishNoticeRequest
Section titled “Input: PublishNoticeRequest”Publishes or replaces a notice. Replacements preserve dismissals unless republish is true. A new publication always has a fresh dismissal revision.
| Field | Type | Description |
|---|---|---|
room_id | string | No field description provided. |
body | string | No field description provided. |
expected_version | string | No field description provided. |
republish | bool | True announces the replacement to members who dismissed the previous notice. False preserves dismissals. A first publication always announces the notice. |
Result: PublishNoticeResponse
Section titled “Result: PublishNoticeResponse”No message description provided.
| Field | Type | Description |
|---|---|---|
notice | RoomNotice | No field description provided. |
ClearNotice
Section titled “ClearNotice”Clears a notice under the same access and version rules as PublishNotice.
POST /api/connect/chatto.api.v1.RoomService/ClearNoticeInput: ClearNoticeRequest
Section titled “Input: ClearNoticeRequest”Clears the current notice without removing its concurrency version.
| Field | Type | Description |
|---|---|---|
room_id | string | No field description provided. |
expected_version | string | No field description provided. |
Result: ClearNoticeResponse
Section titled “Result: ClearNoticeResponse”No message description provided.
| Field | Type | Description |
|---|---|---|
notice | RoomNotice | No field description provided. |
GetRoomReadState
Section titled “GetRoomReadState”Reads the current viewer’s stored marker without changing it. Requires the same membership and read access as MarkRoomAsRead. Missing resources return NOT_FOUND; inaccessible resources return PERMISSION_DENIED.
POST /api/connect/chatto.api.v1.RoomService/GetRoomReadStateInput: GetRoomReadStateRequest
Section titled “Input: GetRoomReadStateRequest”Request current room read state without changing it.
| Field | Type | Description |
|---|---|---|
room_id | string | Room ID. |
Result: GetRoomReadStateResponse
Section titled “Result: GetRoomReadStateResponse”Current room read state, including an absent marker when none is stored.
| Field | Type | Description |
|---|---|---|
state | RoomReadState | State for the requested room and viewer. |
BatchGetRoomReadStates
Section titled “BatchGetRoomReadStates”Reads up to 100 states under the same authorization as GetRoomReadState. Missing and inaccessible resources are omitted; duplicates use first-seen order.
POST /api/connect/chatto.api.v1.RoomService/BatchGetRoomReadStatesInput: BatchGetRoomReadStatesRequest
Section titled “Input: BatchGetRoomReadStatesRequest”Request room read states. Duplicates are removed in first-seen order.
| Field | Type | Description |
|---|---|---|
room_ids | repeated string | Up to 100 room IDs. Missing or inaccessible rooms are omitted. |
Result: BatchGetRoomReadStatesResponse
Section titled “Result: BatchGetRoomReadStatesResponse”Accessible room read states in first-seen request order.
| Field | Type | Description |
|---|---|---|
states | repeated RoomReadState | States for the current viewer. An absent marker does not omit the state. |
CreateRoom
Section titled “CreateRoom”Creates a new channel room in a room group. The caller must be allowed to create rooms in the target group.
POST /api/connect/chatto.api.v1.RoomService/CreateRoomInput: CreateRoomRequest
Section titled “Input: CreateRoomRequest”Request to create a channel room.
| Field | Type | Description |
|---|---|---|
name | string | Required. Visible 1–30-code-point Unicode name of the new channel room. The server trims and stores it in NFC form. Control characters and Unicode line or paragraph separators are rejected. |
description | string | Optional room description. |
group_id | string | Required. Room group that should contain the new channel. |
universal | bool | Whether the new channel should grant effective membership to eligible server members. |
threading_mode | RoomThreadingMode | Threading policy for the new channel. UNSPECIFIED selects ENABLED. |
Result: CreateRoomResponse
Section titled “Result: CreateRoomResponse”Result of creating a room.
| Field | Type | Description |
|---|---|---|
room | Room | Created room. |
UpdateRoom
Section titled “UpdateRoom”Updates a room’s editable metadata. The caller must be allowed to manage rooms. Direct-message rooms cannot be universal.
POST /api/connect/chatto.api.v1.RoomService/UpdateRoomInput: UpdateRoomRequest
Section titled “Input: UpdateRoomRequest”Request to update a room’s editable metadata. update_mask selects editable fields to apply or reset. Fields outside the mask stay unchanged.
| Field | Type | Description |
|---|---|---|
room_id | string | Required. Room to update. |
name | optional string | New visible 1–30-code-point Unicode room name, when changing it. The server trims and stores it in NFC form. Control characters and Unicode line or paragraph separators are rejected. |
description | optional string | New room description, when changing it. Empty clears the description. |
universal | optional bool | New universal membership state, when changing it. Direct-message rooms cannot be universal. |
slow_mode_seconds | optional uint32 | New per-user root posting interval in seconds. Zero disables slow mode. The maximum supported interval is six hours. Direct-message rooms cannot use slow mode. |
threading_mode | optional RoomThreadingMode | New threading policy. Direct-message rooms cannot set this field, and an explicitly supplied UNSPECIFIED or unknown value is rejected. |
update_mask | google.protobuf.FieldMask | Editable fields to apply or reset: name, description, universal, slow_mode_seconds, threading_mode, thread_slow_mode_seconds, show_membership_events. 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. |
thread_slow_mode_seconds | optional uint32 | Per-user interval within each thread. The root starts its author’s timer. Zero disables it. Updating this field does not change the root interval. |
show_membership_events | optional bool | Whether clients show join/leave activity in this channel’s history and live timeline. Requires room.manage. Selecting an absent value resets to true. |
Result: UpdateRoomResponse
Section titled “Result: UpdateRoomResponse”Result of updating a room.
| Field | Type | Description |
|---|---|---|
room | Room | Updated room. |
ArchiveRoom
Section titled “ArchiveRoom”Archives a room so it is hidden from active room lists. The caller must be allowed to manage rooms.
POST /api/connect/chatto.api.v1.RoomService/ArchiveRoomInput: ArchiveRoomRequest
Section titled “Input: ArchiveRoomRequest”Request to archive a room.
| Field | Type | Description |
|---|---|---|
room_id | string | Required. Room to archive. |
Result: ArchiveRoomResponse
Section titled “Result: ArchiveRoomResponse”Result of archiving a room.
| Field | Type | Description |
|---|---|---|
room | Room | Archived room. |
UnarchiveRoom
Section titled “UnarchiveRoom”Restores an archived room to active room lists. The caller must be allowed to manage rooms.
POST /api/connect/chatto.api.v1.RoomService/UnarchiveRoomInput: UnarchiveRoomRequest
Section titled “Input: UnarchiveRoomRequest”Request to unarchive a room.
| Field | Type | Description |
|---|---|---|
room_id | string | Required. Room to unarchive. |
Result: UnarchiveRoomResponse
Section titled “Result: UnarchiveRoomResponse”Result of unarchiving a room.
| Field | Type | Description |
|---|---|---|
room | Room | Unarchived room. |
JoinRoom
Section titled “JoinRoom”Joins the room as the current user when room permissions allow it.
POST /api/connect/chatto.api.v1.RoomService/JoinRoomInput: JoinRoomRequest
Section titled “Input: JoinRoomRequest”Request to join a room as the current user.
| Field | Type | Description |
|---|---|---|
room_id | string | Required. Room to join. |
Result: JoinRoomResponse
Section titled “Result: JoinRoomResponse”Result of joining a room.
| Field | Type | Description |
|---|---|---|
room | Room | Joined room. |
JoinRoomGroup
Section titled “JoinRoomGroup”Joins every unarchived room in a group that the current user can join. Already-joined and non-joinable rooms are skipped.
POST /api/connect/chatto.api.v1.RoomService/JoinRoomGroupInput: JoinRoomGroupRequest
Section titled “Input: JoinRoomGroupRequest”Request to join all joinable rooms in one room group.
| Field | Type | Description |
|---|---|---|
group_id | string | Required. Room group whose rooms should be joined. |
Result: JoinRoomGroupResponse
Section titled “Result: JoinRoomGroupResponse”Result of joining all joinable rooms in one room group.
| Field | Type | Description |
|---|---|---|
joined_room_ids | repeated string | Room IDs that transitioned from not joined to joined. |
StartDM
Section titled “StartDM”Starts a direct-message room for the current human user and the requested participant set, or fetches its existing DM. message.post is required only when the DM must be created. A valid request from a bot receives PERMISSION_DENIED and cannot use this RPC to fetch an existing DM. New DMs support the caller and at most one other user. New group DMs receive INVALID_ARGUMENT; use a channel room instead. Existing group DMs can still be fetched.
POST /api/connect/chatto.api.v1.RoomService/StartDMInput: StartDMRequest
Section titled “Input: StartDMRequest”Request to start a direct-message room, or fetch an existing one. Human and bot callers need message.post at DM scope to create a room. Participants can fetch an existing DM without message.post. New DMs have at most two distinct participants, including the caller. Larger new participant sets receive INVALID_ARGUMENT. Use a channel room for new group conversations. Existing group DMs remain accessible.
| Field | Type | Description |
|---|---|---|
participant_ids | repeated string | Other participants to include in the direct-message room. The current user is always included by the server. An empty list creates or fetches the caller’s self-DM. |
Result: StartDMResponse
Section titled “Result: StartDMResponse”Result of starting or fetching a direct-message room.
| Field | Type | Description |
|---|---|---|
room | Room | Direct-message room for the participant set. |
LeaveRoom
Section titled “LeaveRoom”Leaves the room as the current user. Direct-message and universal rooms cannot be left.
POST /api/connect/chatto.api.v1.RoomService/LeaveRoomInput: LeaveRoomRequest
Section titled “Input: LeaveRoomRequest”Request to leave a room as the current user.
| Field | Type | Description |
|---|---|---|
room_id | string | Required. Room to leave. |
Result: LeaveRoomResponse
Section titled “Result: LeaveRoomResponse”Result of leaving a room.
ListMembers
Section titled “ListMembers”Lists effective room member IDs in ascending ID order. Resolve user details with UserService.BatchGetUsers. Existing members and room.manage holders may list a channel room; other nonmembers need both room.list and room.join.
POST /api/connect/chatto.api.v1.RoomService/ListMembersInput: ListMembersRequest
Section titled “Input: ListMembersRequest”Request for members of one room.
| Field | Type | Description |
|---|---|---|
room_id | string | Required. Room whose effective members should be listed. Existing members and room.manage holders may list a channel room; other nonmembers need both room.list and room.join. |
search | string | Optional case-insensitive search against login and display name. |
page | PageRequest | Defaults to 250 results when absent or limit is zero. Maximum: 500. |
presence_statuses | repeated PresenceStatus | Optional status filter applied before pagination. Empty means all statuses. Select ONLINE, AWAY, and DO_NOT_DISTURB for all connected members. Presence can change between pages; use realtime updates to keep it current. |
Result: ListMembersResponse
Section titled “Result: ListMembersResponse”Room membership IDs. Resolve profiles with UserService.BatchGetUsers. Empty searches do not read user profiles. Search results require profile reads to match names. Both paths use ascending user ID order.
| Field | Type | Description |
|---|---|---|
user_ids | repeated string | Current member IDs in ascending order. Missing or deleted users are omitted. |
page | PageInfo | Page metadata for the members that match both filters. |
GetMember
Section titled “GetMember”Gets one effective member, including automatic universal membership. Channel-room members, room.manage holders, and user.manage-accounts holders may read members. Bot owners and bot.manage holders may read their target bots only. DMs require caller membership. Returns NOT_FOUND for nonmembers.
POST /api/connect/chatto.api.v1.RoomService/GetMemberInput: GetMemberRequest
Section titled “Input: GetMemberRequest”Request one member of one room by stable user ID.
| Field | Type | Description |
|---|---|---|
room_id | string | Required room ID. |
user_id | string | Required target user ID. |
Result: GetMemberResponse
Section titled “Result: GetMemberResponse”Room member response.
| Field | Type | Description |
|---|---|---|
member | DirectoryMember | Requested room member. |
BatchGetMembers
Section titled “BatchGetMembers”Gets effective member rows for the requested accounts. Uses the same authorization as GetMember; omits unknown accounts and nonmembers.
POST /api/connect/chatto.api.v1.RoomService/BatchGetMembersInput: BatchGetMembersRequest
Section titled “Input: BatchGetMembersRequest”Request room member rows for a set of stable user IDs.
| Field | Type | Description |
|---|---|---|
room_id | string | Required room ID. |
user_ids | repeated string | Required target user IDs. Unknown IDs and users that are not members of the room are omitted from the response. |
Result: BatchGetMembersResponse
Section titled “Result: BatchGetMembersResponse”Batch room member response.
| Field | Type | Description |
|---|---|---|
members | repeated DirectoryMember | Found members. The server preserves first-seen request order and de-duplicates repeated IDs. |
AddMember
Section titled “AddMember”Adds an account as an explicit channel-room member. room.manage for this room or user.manage-accounts overrides the target’s missing room.join. Bot owners and bot.manage holders may also add bots, but without either override the acting human needs effective room.join. The bot’s own room.join is required only when the bot joins itself through JoinRoom. Preserves permission grants. Suspensions, archived, universal, and DM rooms prevent adding.
POST /api/connect/chatto.api.v1.RoomService/AddMemberInput: AddMemberRequest
Section titled “Input: AddMemberRequest”Request to add a user to a channel room.
| Field | Type | Description |
|---|---|---|
room_id | string | Required. Channel room to add the user to. |
user_id | string | Required. User to add as an explicit room member. |
Result: AddMemberResponse
Section titled “Result: AddMemberResponse”Result of adding a user to a room.
| Field | Type | Description |
|---|---|---|
member | DirectoryMember | Added room member. |
RemoveMember
Section titled “RemoveMember”Removes an explicit channel-room member. Requires room.manage for this room, user.manage-accounts, ownership of the target bot, or bot.manage. Removal is allowed after room.join is lost and from archived rooms. Preserves permission grants. Universal and DM membership cannot be edited.
POST /api/connect/chatto.api.v1.RoomService/RemoveMemberInput: RemoveMemberRequest
Section titled “Input: RemoveMemberRequest”Request to remove a user from a channel room.
| Field | Type | Description |
|---|---|---|
room_id | string | Required. Channel room to remove the user from. |
user_id | string | Required. User to remove from the room’s explicit members. |
Result: RemoveMemberResponse
Section titled “Result: RemoveMemberResponse”Result of removing a user from a room.
| Field | Type | Description |
|---|---|---|
removed | bool | True when an explicit room membership was removed by this call. |
ListSuspensions
Section titled “ListSuspensions”Lists active channel room suspensions. Requires server-scope room.remove-member.
POST /api/connect/chatto.api.v1.RoomService/ListSuspensionsInput: ListSuspensionsRequest
Section titled “Input: ListSuspensionsRequest”Request to list active room suspensions.
| Field | Type | Description |
|---|---|---|
room_id | string | Optional channel room filter. Empty lists active suspensions across all rooms. |
page | PageRequest | Defaults to 50 results when absent or limit is zero. Maximum: 100. |
Result: ListSuspensionsResponse
Section titled “Result: ListSuspensionsResponse”Active room suspensions visible to the current moderator.
| Field | Type | Description |
|---|---|---|
suspensions | repeated RoomSuspension | Active suspensions by creation time, newest first; equal times use event ID in ascending order. |
page | PageInfo | Page metadata. |
ListRoomAttachments
Section titled “ListRoomAttachments”Lists current message-owned room attachments. Authentication and room membership are required. Attachments also require message.read or a matching thread relationship with message.read-interactions. The server omits attachments from inaccessible threads. Returns PERMISSION_DENIED when the room is inaccessible to the caller.
POST /api/connect/chatto.api.v1.RoomService/ListRoomAttachmentsInput: ListRoomAttachmentsRequest
Section titled “Input: ListRoomAttachmentsRequest”Request for room-scoped attachment list pages.
| Field | Type | Description |
|---|---|---|
room_id | string | Required room ID. |
thumbnail | ImageTransformOptions | Thumbnail URL options. Defaults are applied when absent. |
page | PageRequest | Defaults to 50 results when absent or limit is zero. Maximum: 100. |
Result: ListRoomAttachmentsResponse
Section titled “Result: ListRoomAttachmentsResponse”Room-scoped attachment list response.
| Field | Type | Description |
|---|---|---|
attachments | repeated RoomAttachmentListItem | Current attachments in newest message order. |
page | PageInfo | Page metadata. |
ListPinnedMessages
Section titled “ListPinnedMessages”Lists current pinned messages in a channel room. Room membership plus message.read or message.read-interactions are required. The server omits pins from threads that the caller cannot read. Direct-message rooms do not support pins.
POST /api/connect/chatto.api.v1.RoomService/ListPinnedMessagesInput: ListPinnedMessagesRequest
Section titled “Input: ListPinnedMessagesRequest”Request to list a channel room’s current pinned messages.
| Field | Type | Description |
|---|---|---|
room_id | string | Required channel room ID. |
page | PageRequest | Defaults to 50 results when absent or limit is zero. Maximum: 100. |
Result: ListPinnedMessagesResponse
Section titled “Result: ListPinnedMessagesResponse”Current pinned messages in one channel room.
| Field | Type | Description |
|---|---|---|
pinned_messages | repeated PinnedMessage | Pinned messages in newest-pin-first order. |
page | PageInfo | Page metadata. |
latest_pin_marker | string | Opaque marker for the latest pin fact observed for this room. The value remains stable when pins are removed so clients can detect new pins without comparing wall-clock timestamps. Clients must not interpret it. |
CreatePinnedMessage
Section titled “CreatePinnedMessage”Pins a current message. The caller must have message.pin and must be able to read the message. Repeating an existing pin is idempotent. Direct-message rooms are rejected.
POST /api/connect/chatto.api.v1.RoomService/CreatePinnedMessageInput: CreatePinnedMessageRequest
Section titled “Input: CreatePinnedMessageRequest”Request to pin a message in a channel room.
| Field | Type | Description |
|---|---|---|
room_id | string | Required channel room ID. |
message_event_id | string | Required canonical message event ID. Thread replies are supported. |
Result: CreatePinnedMessageResponse
Section titled “Result: CreatePinnedMessageResponse”Result of pinning a message.
| Field | Type | Description |
|---|---|---|
pinned_message | PinnedMessage | Current pinned-message resource. Repeating an existing pin returns it. |
DeletePinnedMessage
Section titled “DeletePinnedMessage”Removes a current pin. The caller must have message.pin. Removing a missing pin is idempotent. Direct-message rooms are rejected.
POST /api/connect/chatto.api.v1.RoomService/DeletePinnedMessageInput: DeletePinnedMessageRequest
Section titled “Input: DeletePinnedMessageRequest”Request to unpin a message from a channel room.
| Field | Type | Description |
|---|---|---|
room_id | string | Required channel room ID. |
message_event_id | string | Required canonical message event ID. |
Result: DeletePinnedMessageResponse
Section titled “Result: DeletePinnedMessageResponse”Result of unpinning a message.
| Field | Type | Description |
|---|---|---|
deleted | bool | True when the message is not pinned after this call. |
RefreshTypingIndicator
Section titled “RefreshTypingIndicator”Refreshes the current user’s live-only typing indicator for a room or thread. Room membership is required; message posting permission is not. Send at most once every 2 seconds while typing. After posting a message, the next typing activity can send immediately. Stop sending when typing stops; receivers clear the indicator after 6 seconds without an event.
POST /api/connect/chatto.api.v1.RoomService/RefreshTypingIndicatorInput: RefreshTypingIndicatorRequest
Section titled “Input: RefreshTypingIndicatorRequest”Request to refresh the current user’s live-only typing indicator.
| Field | Type | Description |
|---|---|---|
room_id | string | Required. Room where the current user is typing. |
thread_root_event_id | string | Event ID of the thread root when typing inside a thread. |
Result: RefreshTypingIndicatorResponse
Section titled “Result: RefreshTypingIndicatorResponse”Result of refreshing a typing indicator.
GetRoomEvents
Section titled “GetRoomEvents”Returns one page of room timeline events, including related user data needed to render the page. Room membership is required. Reads also require message.read or message.read-interactions. The server returns only related thread roots for an interaction-scoped caller.
POST /api/connect/chatto.api.v1.RoomService/GetRoomEventsInput: GetRoomEventsRequest
Section titled “Input: GetRoomEventsRequest”Request for a page of room timeline events.
Omit the cursor to load the initial page. Set before to a previously returned start_cursor to page toward older events, or after to a previously returned end_cursor to page toward newer events.
| Field | Type | Description |
|---|---|---|
room_id | string | Required. Room whose timeline should be loaded. |
limit | int32 | Maximum events. Values at or below zero use 50; values above 500 use 500. |
cursor.before | string | Return events older than this opaque cursor. |
cursor.after | string | Return events newer than this opaque cursor. |
Result: GetRoomEventsResponse
Section titled “Result: GetRoomEventsResponse”Response containing one room timeline page.
| Field | Type | Description |
|---|---|---|
page | RoomTimelinePage | Loaded timeline page. |
GetRoomEventsAround
Section titled “GetRoomEventsAround”Returns a room timeline window centered around a specific event. Use this to open a permalink, search result, or notification target in context. Returns NOT_FOUND when the anchor event is missing or not visible in the room timeline. Returns PERMISSION_DENIED when room membership or both read modes are missing, or when the anchor is in an unrelated thread.
POST /api/connect/chatto.api.v1.RoomService/GetRoomEventsAroundInput: GetRoomEventsAroundRequest
Section titled “Input: GetRoomEventsAroundRequest”Request for room timeline events around a specific event.
Use this when a client needs to jump to a known event and render enough context around it.
| Field | Type | Description |
|---|---|---|
room_id | string | Required. Room whose timeline should be loaded. |
event_id | string | Required. Anchor event ID that should appear in the returned page. |
limit | int32 | Maximum events around the anchor. Values at or below zero use 50; values above 500 use 500. |
Result: GetRoomEventsAroundResponse
Section titled “Result: GetRoomEventsAroundResponse”Response containing a room timeline window around a specific event.
| Field | Type | Description |
|---|---|---|
page | RoomTimelinePage | Loaded timeline page. |
target_index | int32 | Zero-based index of the anchor event within page.events. |
MarkRoomAsRead
Section titled “MarkRoomAsRead”Marks a room timeline as read through the supplied event. Room membership is required. Reads also require message.read or message.read-interactions. If no event is supplied, the server marks through the latest root event that the caller can read. Clients usually call this after the user has viewed the latest visible event in the room.
POST /api/connect/chatto.api.v1.RoomService/MarkRoomAsReadInput: MarkRoomAsReadRequest
Section titled “Input: MarkRoomAsReadRequest”Request to mark a room timeline as read.
| Field | Type | Description |
|---|---|---|
room_id | string | Required. Room whose timeline should be marked read. |
up_to_event_id | string | Highest room event ID the current user has read. When set, the event must exist as a root event in the room timeline. Leave empty to mark through the room’s current latest root event. |
Result: MarkRoomAsReadResponse
Section titled “Result: MarkRoomAsReadResponse”Result of marking a room timeline as read.
Clients can use the previous timestamp to place a local New messages separator. Notification policy controls room Badge attention separately.
| Field | Type | Description |
|---|---|---|
last_read_at | google.protobuf.Timestamp | New room read timestamp stored for the current user. |
previous_last_read_at | google.protobuf.Timestamp | Previous room read timestamp, when one existed. |
RemoveUser
Section titled “RemoveUser”Removes a current channel room member with a required reason. Requires room.remove-member. Without suspension, ordinary join rules apply afterward. Universal rooms require a suspension. Direct-message rooms are excluded.
POST /api/connect/chatto.api.v1.RoomService/RemoveUserInput: RemoveUserRequest
Section titled “Input: RemoveUserRequest”Request to remove a user from a channel room for moderation.
| Field | Type | Description |
|---|---|---|
room_id | string | Required. Channel room to remove the user from. |
user_id | string | Required. Current room member to remove. |
reason | string | Required moderator-entered reason stored for audit. |
suspension.suspension_expires_at | google.protobuf.Timestamp | Future time after which the user may rejoin. |
suspension.suspend_indefinitely | bool | Must be true. The user cannot rejoin until the suspension is lifted. |
Result: RemoveUserResponse
Section titled “Result: RemoveUserResponse”Result of a moderated room removal.
LiftSuspension
Section titled “LiftSuspension”Lifts an active channel room suspension. Requires room.remove-member. Calling this when no active suspension exists succeeds.
POST /api/connect/chatto.api.v1.RoomService/LiftSuspensionInput: LiftSuspensionRequest
Section titled “Input: LiftSuspensionRequest”Request to lift a channel room suspension.
| Field | Type | Description |
|---|---|---|
room_id | string | Required. Channel room containing the suspension. |
user_id | string | Required. Suspended user. |
reason | string | Required moderator-entered reason stored for audit. |
Result: LiftSuspensionResponse
Section titled “Result: LiftSuspensionResponse”Result of lifting a room suspension.