Deletes the role with the specified id.

<Check title="Required Permissions" icon="key">The user must be an admin or have `workspace-manage-config:write` permissions.</Check>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

roleIdstringRequiredformat: "uuid"
The id of the role.

Request

The delete role form payload.
newRoleIdstring or nullOptionalformat: "uuid"
The id of the role to which all users of the old role will be moved. Required if there are users assigned to the role being deleted.

Response

No Content

Errors