Add Role to Users

This command (add_role_to_users) adds a role to a list of users. Useful for rapidly applying roles to 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 added must be assignable — 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 assigned.

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)

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: