Deletes the role with the specified id.

POST

If there are still users in this role an id of a different role must be specified to move the users to that role.

Required Permissions: The user must be an admin or have workspace-manage-config:write permissions.

Path parameters

roleIdstringRequired
The id of the role.

Request

This endpoint expects an object.
newRoleIdstringOptional
The id of the role to which all users of the old role will be moved.