# delete_workspace_role

Source: https://modulify.ai/docs/mcp/workspaces/delete-workspace-role

Deletes a custom role from a workspace and moves everyone holding it back to the stock Member role.

- Title: Delete a role
- Scope: `workspaces:write`
- Access: Destructive

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](https://modulify.ai/docs/reference/members-and-roles#delete-a-custom-role).

## Inputs

| Input | Type | Required | Description |
| --- | --- | --- | --- |
| `workspaceId` | string | Yes | The workspace id. |
| `roleId` | string | Yes | The role id. |