🚫
Remove Role
base.role.removeBase SetUserThe flip side of Add Role — takes a role away from a user. Use it for role rotation, timed access, punishments, or when someone no longer meets the criteria for a role.
When to use this
- →The Error port fires if the user doesn't have the role — use it to gracefully handle edge cases
On the canvas
This is what Remove Role looks like when you place it on your flow. Each field below is something you configure in the inspector panel.
🚫User
Remove Role
base.role.removeuserIdrequired
{{user.id}}
roleIdrequired
123456789012345
output
error
Config fields
| Field | Type | Req | What it does |
|---|---|---|---|
userId{{user.id}} | text | yes | Whose role to remove 👤 |
roleId123456789012345 | text | yes | Which role (ID) 🚫 |
Output ports
outputRole removed, moving on
errorCouldn't remove the role — check IDs and permissions
📐
In TypeScript, this would be…
Not something you need to write — just a look at what Kitcord does for you.
TypeScript
try {
const member = await guild.members.fetch(userId);
await member.roles.remove(roleId);
} catch {
// Error port
}Related pieces
More User pieces