# Participant rights and roles
# Roles description
TrueConf Server supports the following roles within the chat:
owner
- group chat owner;admin
- appointed moderator of the group chat;user
- regular participant of a group chat;conf_owner
— a role assigned to the owner of the conference; used only in conference chats.conf_moderator
— the role of the conference moderator (operator); used exclusively in conference chats.favorites_owner
— the role of the Favorites chat owner; used only in this type of chat.writer
- the role of a user who has permission to write in a chat of type channel; used only in this context. type of chat.
You can obtain the list of chat participants along with their roles using the getChatParticipants request.
# Role permissions in a regular chat
owner | admin | user | conf_owner | conf_moderator | favorites_owner | |
---|---|---|---|---|---|---|
Reading messages | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Sending messages | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Adding participants to chat | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Removing participants from chat | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Editing own messages | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Deleting own messages for oneself | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Deleting own messages for all | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Deleting others' messages for oneself | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
Deleting others' messages for all | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
Clearing chat history for oneself | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Clearing chat history for all | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
Replying to messages | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Forwarding messages to/from chat | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Sending files | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Sending geolocation | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Sending contacts | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Sending emoji | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Sending stickers | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ |
Pinning messages | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ |
Changing chat name | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Changing chat icon | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Changing chat participant roles | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
Granting rights to chat participants | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
Revoking chat participant rights | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
Blocking participants | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
Changing chat owner | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
Setting the first visible message | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ |
Sending polls | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
# Role permissions in the channel
owner | admin | user | conf_owner | conf_moderator | favorites_owner | writer | |
---|---|---|---|---|---|---|---|
Reading messages | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Sending messages | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ |
Adding participants to chat | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
Removing participants from chat | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
Editing own messages | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ |
Deleting own messages for oneself | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ❌ |
Deleting own messages for everyone | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ |
Deleting others' messages for oneself | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
Deleting others' messages for everyone | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
Clearing chat history for oneself | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ❌ |
Clearing chat history for everyone | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
Replying to messages | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ |
Forwarding messages in/out of chat | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Sending files | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ |
Sending location | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ |
Sending contacts | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ |
Sending emojis | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ |
Sending stickers | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ |
Pinning messages | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ |
Changing chat title | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
Changing chat icon | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
Changing chat participants' roles | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
Granting rights to chat participants | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
Revoking chat participant rights | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
Blocking participants | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
Changing chat owner | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
Setting the first visible message | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ |
Sending polls | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ |