Remove Role from Users

This command (remove_role_from_users) removes a role from a list of users. Useful for rapidly removing roles from an external list of users.

Permissions

Bot Permissions

• The bot must have the MANAGE_ROLES permission.
• The bot's highest role must be higher in the role hierarchy than the role it is being requested to assign.
• The role being removed must be removable — i.e. it should not be an external integration role.

User Permissions

• The user's highest role must be higher in the role hierarchy than the role they want to be removed.

Parameters

role

Required. This is the role that you want to add to the user list.

list

Required. This is the list of users to add the role to. The list should a space-separated list of @mentions (like @user1 @user2). To remove a role from all users, type @everyone instead.

ephemeral

Optional. Whether other server members should be able to see the bot's response. Does not affect logging.

Cooldown

Like other commands, cooldowns operate at the server level. The cooldown values are: