CommunityRoleCreateRequest
CommunityRoleCreateRequest =
object
Request object for creating a new role in the community.
Properties
channelPermission?
optionalchannelPermission?:ChannelPermission
The default channel permissions to grant. Optional. See ChannelPermission for available flags.
colorHex?
optionalcolorHex?:string
The hex color code for the role, in #RRGGBB format (a # followed by 6 hexadecimal digits). Optional. Defaults to #FFFFFF if not specified.
communityPermission?
optionalcommunityPermission?:CommunityPermission
The community-level permissions to grant. Optional. See CommunityPermission for available flags.
isMentionable
isMentionable:
boolean
Whether the role can be mentioned in messages. Required.
name
name:
string
The display name for the role. Required. Must be 1 to 100 characters and contain only letters, numbers, and hyphens. Spaces are not allowed, and the name cannot start or end with a hyphen or contain consecutive hyphens. A name that violates these rules fails with RequestValidationFailed. To build a role name from arbitrary text (for example, a user-entered tier name), replace each run of disallowed characters with a single hyphen and trim leading and trailing hyphens.