DELETE /roles/<rid>

Deletes the role with the specified role ID. Users who had this role (either directly or through a user group) immediately lose the role and all permissions granted by it, but their session is otherwise unaffected. The next action the user takes in PE is determined by their permissions without the deleted role.

Request format

When Forming RBAC API requests to this endpoint, the URI path must include the ID of the role you want to delete. For example:

curl -X DELETE "https://$(puppet config print server):4433/rbac-api/v1/roles/1234" \
-H "X-Authentication:$(puppet-access show)"

Response format

Returns a 200 OK response if the role was deleted.

Error responses

Returns a 404 Not Found response if no role exists for the specified role ID.

Returns a 403 Forbidden response if the requesting user lacks permission to delete the role identified by role ID.

For other errors, refer to RBAC service errors .