You can delete a role using the or the . Roles are used with the API Authorization Core feature set. For role-based access control (RBAC) to work properly, you must enable it for your API using either the Dashboard or the Management API. The Authorization Core functionality is different from the Authorization Extension. For a comparison, read Authorization Core vs. Authorization Extension.

Dashboard

  1. Go to Dashboard > User Management > Roles and click the name of the role to view.
  2. Click Remove this Role, and confirm.

Management API

Make a DELETE call to the Delete Role endpoint. Be sure to replace ROLE_ID and MGMT_API_ACCESS_TOKEN placeholder values with your role ID and Management API , respectively.
curl --request DELETE \
  --url 'https://{yourDomain}/api/v2/roles/ROLE_ID' \
  --header 'authorization: Bearer MGMT_API_ACCESS_TOKEN'
ValueDescription
ROLE_IDΤhe ID of the role you want to delete.
MGMT_API_ACCESS_TOKENAccess Token for the Management API with the scope delete:roles.

Learn more