Role Tools

Guild role lifecycle and ordering.

Role tools are sensitive because they can change permissions and hierarchy inside a guild. Use strict target and permission headers when exposing them to end users.

create_guild_role #

• Purpose: create a role in a guild.
• Key arguments: guild_id or guild_name.
• Optional fields: role fields (name, permissions, color, etc.).

edit_guild_role #

• Purpose: edit role attributes.
• Key arguments: guild scope, role identity.
• Optional fields: editable role fields.

delete_guild_role #

• Purpose: delete a role.
• Key arguments: guild scope, role identity.

reorder_guild_roles #

• Purpose: reorder role positions.
• Key arguments: guild scope, positions array.
• Notes:
• Reordering can indirectly affect moderation and administrative power.
• Discord's own hierarchy checks still apply.