Latest Content

How to Delete a Role

Updated on 08 April, 2026

Delete an IAM role from your Vultr organization. Remove the role and disassociate all attached policies, users, and groups from the role in the IAM system.

Deleting a role removes it from your organization. Users and groups that were assigned the role lose any permissions granted through it. The role can be restored using the Restore Role endpoint if you have its id.

Note
Deleting a role does not delete the policies attached to it. Policies remain available and can be attached to other roles.

This guide explains how to delete a role using the Vultr Console and the Vultr API.

  • Vultr Console
  • Vultr API
  1. Log in to the Vultr Console.
  2. Click the organization name in the top navigation bar.
  3. Click Manage Organization.
  4. Click the Roles tab.
  5. Click the Delete icon next to the role you want to delete.
  6. Click Delete. The role is removed from the list. Users and groups that were assigned this role lose the associated permissions.

  1. Send a GET request to the List Roles endpoint to retrieve all roles in your organization.

    console 
    $ curl "https://api.vultr.com/v2/roles" \
    -X GET \
    -H "Authorization: Bearer ${VULTR_API_KEY}"

    Note the id of the role you want to delete.

  2. Send a DELETE request to the Delete Role endpoint to delete the role. Replace {role-id} with the id of the role you want to delete.

    console 
    $ curl "https://api.vultr.com/v2/roles/{role-id}" \
    -X DELETE \
    -H "Authorization: Bearer ${VULTR_API_KEY}"

    A successful deletion returns an HTTP 204 No Content response with no response body.

  3. Send a GET request to the List Roles endpoint to retrieve all roles.

    console 
    $ curl "https://api.vultr.com/v2/roles" \
    -X GET \
    -H "Authorization: Bearer ${VULTR_API_KEY}"

    Verify that the deleted role no longer appears in the list.

Comments