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.