Create a Discord guild role
Creates a new role in the guild.
Requires the bot to hold the Manage Roles permission. Guilds that added the Zernio bot before role management shipped must re-invite it, because Discord applies the permission set at invite time.
Discord's role hierarchy applies: the bot cannot create a role positioned at or above its own highest role, and cannot grant permissions it does not itself hold. Either attempt returns a 403 carrying Discord's own error.
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
Discord guild snowflake ID
Query Parameters
SocialAccount _id of the Discord account bound to this guild
1 <= length <= 100Decimal color (0 = no color). 0xFF0000 red is 16711680.
0 <= value <= 16777215Display members with this role separately in the member list
Allow anyone to @mention this role
Permissions bitfield as a stringified integer
Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.discord.createDiscordGuildRole({ path: { guildId: 'guild_abc123', }, query: { accountId: 'account_abc123', }, body: { name: 'Example', },});console.log(data);{
"data": {
"id": "string",
"name": "string",
"color": 0,
"position": 0,
"permissions": "string",
"managed": true,
"mentionable": true,
"hoist": true
}
}{
"error": "Unauthorized"
}List Discord guild roles GET
Returns all roles in a Discord guild. Useful for building role-mention pickers, role-permission UIs, or finding the role ID before calling the role-assign endpoint. Roles are returned unordered — sort client-side by `position` if you need Discord's UI ordering. Caller must pass `accountId` of a Discord SocialAccount bound to this guild (route verifies team access + guild match).
Edit a Discord guild role PATCH
Updates a role's name, color, hoist, mentionable flag, or permission bitfield. At least one field must be supplied. Omitted fields are left unchanged. Requires the bot to hold Manage Roles, and the target role must sit below the bot's highest role. See the create-role operation for the re-invite requirement.