Deleting a Role

To delete a role, send the DELETE method and specify the role ID (name) in the URL.

In the community edition of the server, or commercial editions without organizations, use the first form of the URL.
In commercial editions with organizations, use the second URL to specify the user’s organization. When specifying the organization, use its unique ID, not its path. When logged in as the system admin (superuser), use the first URL to delete roles of the root organization.

When this method is successful, the role is permanently deleted.






Return Value on Success

Typical Return Values on Failure

204 No Content – The role was successfully deleted.

404 Not Found – When the ID of the organization cannot be resolved.