Action: Remove User Role

Discord Operation

The Remove User Role action in Discord revokes a specific role (and its permissions) from a user on a server.

Example User Story

I want to restrict a member’s access to admin channels after their project ends, so I use the Remove User Role action in Discord to take away their "Project Lead" role.

Fields

Field Name	Field Type	Required
guildID	String	Yes
userID	String	Yes
roleID	String	Yes
botToken	String	Yes

Related Connections

Discord

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "remove-user-role",
  "state": "inDev",
  "meta": {
    "short": "Remove User Role",
    "description": "Removes a specified role from a user in a Discord server."
  },
  "input": [
    {
      "name": "guildID",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The ID of the Discord server (guild)."
      }
    },
    {
      "name": "userID",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The ID of the user to remove the role from."
      }
    },
    {
      "name": "roleID",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The ID of the role to remove from the user."
      }
    },
    {
      "name": "botToken",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The bot token for authenticating with the Discord API."
      }
    }
  ],
  "output": [
    {
      "name": "success",
      "type": "Boolean",
      "selector": [],
      "meta": {
        "description": "Indicates whether the role was successfully removed."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "DELETE",
        "path": "/guilds/{{guildID}}/members/{{userID}}/roles/{{roleID}}",
        "headers": {
          "Content-Type": "application/json"
        }
      }
    }
  ]
}