PLEXICHATNarrative Docs
Permissions
Guides, route-group overviews, and live schema entry points for the Plexichat backend.
REST http://api.plexichat.com/api/v1Gateway ws://api.plexichat.com/gatewayVersion a.1.0-49
Permissions
Plexichat permissions are string-based capabilities such as messages.send or admin.system.
Runtime Summary
| Metric | Value |
|---|---|
| Permission categories | 11 |
| Total permissions | 49 |
Categories
| Category | Permission count | Included permissions |
|---|---|---|
account | 3 | account.delete, account.edit_profile, account.view_others |
admin | 3 | admin.servers, admin.system, admin.users |
bots | 2 | bots.create, bots.manage |
channels | 3 | channels.create, channels.delete, channels.manage |
conversations | 7 | conversations.create, conversations.delete, conversations.invite, conversations.join, conversations.kick, conversations.leave, conversations.manage |
messages | 7 | messages.delete, messages.delete_others, messages.edit, messages.pin, messages.react, messages.read, messages.send |
moderation | 5 | moderation.ban, moderation.kick, moderation.mute, moderation.view_audit, moderation.warn |
roles | 4 | roles.assign, roles.create, roles.delete, roles.manage |
servers | 6 | servers.create, servers.delete, servers.invite, servers.join, servers.leave, servers.manage |
video | 3 | video.initiate, video.join, video.stream |
voice | 6 | voice.deafen_others, voice.initiate, voice.join, voice.move_others, voice.mute_others, voice.speak |
Permission Catalog
| Permission | Category | Default user | Default bot | Bot restricted | Description |
|---|---|---|---|---|---|
account.delete | account | Yes | No | Yes | Delete own account |
account.edit_profile | account | Yes | No | No | Edit own profile |
account.view_others | account | Yes | Yes | No | View other user profiles |
admin.servers | admin | No | No | Yes | Manage all servers |
admin.system | admin | No | No | Yes | System administration |
admin.users | admin | No | No | Yes | Manage all users |
bots.create | bots | Yes | No | Yes | Create bot accounts |
bots.manage | bots | Yes | No | Yes | Manage own bots |
channels.create | channels | No | No | No | Create channels in servers |
channels.delete | channels | No | No | No | Delete channels |
channels.manage | channels | No | No | No | Manage channel settings |
conversations.create | conversations | Yes | No | No | Create new conversations |
conversations.delete | conversations | No | No | No | Delete conversations |
conversations.invite | conversations | Yes | No | No | Invite others to conversations |
conversations.join | conversations | Yes | Yes | No | Join conversations |
conversations.kick | conversations | No | No | No | Remove others from conversations |
conversations.leave | conversations | Yes | Yes | No | Leave conversations |
conversations.manage | conversations | No | No | No | Manage conversation settings |
messages.delete | messages | Yes | Yes | No | Delete own messages |
messages.delete_others | messages | No | No | No | Delete others messages (moderator) |
messages.edit | messages | Yes | Yes | No | Edit own messages |
messages.pin | messages | No | No | No | Pin messages |
messages.react | messages | Yes | Yes | No | Add reactions to messages |
messages.read | messages | Yes | Yes | No | Read messages in conversations |
messages.send | messages | Yes | Yes | No | Send messages in conversations |
moderation.ban | moderation | No | No | No | Ban users from servers |
moderation.kick | moderation | No | No | No | Kick users from servers |
moderation.mute | moderation | No | No | No | Mute users in servers |
moderation.view_audit | moderation | No | No | No | View moderation audit log |
moderation.warn | moderation | No | No | No | Warn users |
roles.assign | roles | No | No | No | Assign roles to members |
roles.create | roles | No | No | No | Create roles in servers |
roles.delete | roles | No | No | No | Delete roles |
roles.manage | roles | No | No | No | Manage role permissions |
servers.create | servers | Yes | No | No | Create new servers |
servers.delete | servers | No | No | No | Delete servers |
servers.invite | servers | No | No | No | Create server invites |
servers.join | servers | Yes | No | No | Join servers |
servers.leave | servers | Yes | No | No | Leave servers |
servers.manage | servers | No | No | No | Manage server settings |
video.initiate | video | Yes | No | No | Start video calls |
video.join | video | Yes | No | No | Join video calls |
video.stream | video | Yes | No | No | Stream video |
voice.deafen_others | voice | No | No | No | Deafen other users |
voice.initiate | voice | Yes | No | No | Start voice calls |
voice.join | voice | Yes | No | No | Join voice channels |
voice.move_others | voice | No | No | No | Move users between channels |
voice.mute_others | voice | No | No | No | Mute other users |
voice.speak | voice | Yes | No | No | Speak in voice channels |
Usage Notes
- user and bot tokens may have different effective permission grants
- bot-restricted permissions should not be granted to automated accounts
- wildcard grants such as
messages.*and*can expand access significantly - application- or server-specific role systems can layer additional policy on top of these base permissions