Latest Content

How to Delete a Role

Updated on 01 June, 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.

Follow this guide to delete a role using the Vultr Console, the Vultr API, or Terraform.

  • Vultr Console
  • Vultr API
  • Terraform
  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.

  1. Ensure the Vultr Terraform provider is configured in your Terraform project.

  2. Destroy the role resource. Replace my_role with the resource label used in your configuration.

    console 
    $ terraform destroy -target=vultr_organization_role.my_role

    Alternatively, remove the vultr_organization_role block from your configuration and run:

    console 
    $ terraform apply

    Verify that the output shows vultr_organization_role.my_role: Destruction complete.

Comments