RoomInvitationService

Chatto exposes this service below /api/connect.

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

RoomInvitationService

Invitations grant membership only after the recipient accepts them.

CreateRoomInvitation

Requires room membership and room.invite. A duplicate from the same sender returns the pending invitation. A pending invitation from a different sender returns INVALID_ARGUMENT.

POST /api/connect/chatto.api.v1.RoomInvitationService/CreateRoomInvitation

Input: CreateRoomInvitationRequest

No message description provided.

Field	Type	Description
room_id	string	No field description provided.
recipient_id	string	No field description provided.

Result: CreateRoomInvitationResponse

No message description provided.

Field	Type	Description
invitation	RoomInvitation	No field description provided.

GetRoomInvitation

Returns NOT_FOUND for absent or inaccessible invitations.

POST /api/connect/chatto.api.v1.RoomInvitationService/GetRoomInvitation

Input: GetRoomInvitationRequest

No message description provided.

Field	Type	Description
invitation_id	string	No field description provided.

Result: GetRoomInvitationResponse

No message description provided.

Field	Type	Description
invitation	RoomInvitation	No field description provided.

BatchGetRoomInvitations

Omits absent and inaccessible invitations. Accepts at most 100 IDs.

POST /api/connect/chatto.api.v1.RoomInvitationService/BatchGetRoomInvitations

Input: BatchGetRoomInvitationsRequest

No message description provided.

Field	Type	Description
invitation_ids	repeated string	No field description provided.

Result: BatchGetRoomInvitationsResponse

No message description provided.

Field	Type	Description
invitations	repeated RoomInvitation	No field description provided.

ListRoomInvitations

Lists the caller’s received or sent invitations, newest first. Default 50, maximum 100.

POST /api/connect/chatto.api.v1.RoomInvitationService/ListRoomInvitations

Input: ListRoomInvitationsRequest

No message description provided.

Field	Type	Description
page	PageRequest	No field description provided.
sent	bool	Select sent invitations instead of invitations received by the caller.
pending_only	bool	Restrict to unexpired pending invitations.

Result: ListRoomInvitationsResponse

No message description provided.

Field	Type	Description
invitations	repeated RoomInvitation	No field description provided.
page	PageInfo	No field description provided.

AcceptRoomInvitation

Recipient-only. Rechecks sender authority and bypasses only room.join.

POST /api/connect/chatto.api.v1.RoomInvitationService/AcceptRoomInvitation

Input: AcceptRoomInvitationRequest

No message description provided.

Field	Type	Description
invitation_id	string	No field description provided.

Result: AcceptRoomInvitationResponse

No message description provided.

Field	Type	Description
invitation	RoomInvitation	No field description provided.

DeclineRoomInvitation

Recipient-only. Does not change membership or notification preferences.

POST /api/connect/chatto.api.v1.RoomInvitationService/DeclineRoomInvitation

Input: DeclineRoomInvitationRequest

No message description provided.

Field	Type	Description
invitation_id	string	No field description provided.

Result: DeclineRoomInvitationResponse

No message description provided.

Field	Type	Description
invitation	RoomInvitation	No field description provided.