Update role
update_roleEdit a Discord role's name, color, icon, hoist, mentionable flag, or permissions; only passed fields change, and sensitive permission updates require confirmation.
Instructions
Edit a role's name, color (solid, gradient, or holographic), icon, hoist, mentionable flag, or permissions. Passing preset and/or permissions replaces the role's permission set with the named bundle plus listed names. Only passed fields change. Supports dry_run. A permission change that would give the role moderator or admin powers (such as banning, kicking, or timing out members, deleting other people's messages, or managing the server, roles, or channels), or let it see channels it cannot see now, needs confirming: the first call changes nothing and returns a preview and a confirm_token, and repeating the call with the token makes the change.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"role": "<role>"
},
"name": "update_role"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| role | Yes | Role name or ID. | |
| color | No | Hex color like #00b0f4. | |
| guild | No | Guild (server) name or ID. Omit to use the default guild. | |
| hoist | No | ||
| preset | No | ||
| dry_run | No | ||
| icon_url | No | Public URL of a small image (png, jpeg, webp; 256 KB) shown beside members' names, or none to remove. Needs boost level 2. | |
| icon_emoji | No | A standard emoji shown beside members' names instead of an image, or none to remove. Needs boost level 2. | |
| holographic | No | Discord's holographic style, which uses its own three colors; false for a solid color. Needs the Enhanced Role Colors server feature. | |
| mentionable | No | ||
| permissions | No | ||
| confirm_token | No | The token from this exact action's preview. Where the app can show a confirmation dialog, calling with it asks the user there, and it happens only if they agree. | |
| secondary_color | No | A second hex color, so the role name shows a gradient from color to this one; none for a solid color. Needs the Enhanced Role Colors server feature. |