Delete a role
delete_workspace_role
Deletes a custom role from a workspace and moves everyone holding it back to the stock Member role.
Scopeworkspaces:writeDestructive
The role is gone for good, and the access of everyone who held it changes the moment this runs. Recreating the role does not undo that. The tool tells the client to read get_role_member_counts first and tell you how many people it affects before calling it.
It needs the Manage roles permission (roles.manage) and the workspace on Pro or Enterprise, otherwise it is refused with You must upgrade to the Pro plan to manage roles! The built-in owner and member roles cannot be deleted. See Members and roles.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
workspaceId |
string | Yes | The workspace id. |
roleId |
string | Yes | The role id. |