---
title: How to Delete a Role
url: https://docs.vultr.com/platform/iam/roles/how-to-delete-a-role
description: 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.
publish_date: 2026-03-24T19:52:38.440336Z
last_updated: 2026-06-01T21:29:32.722060Z
---

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"

    1. Log in to the [Vultr Console](https://console.vultr.com).
    1. Click the organization name in the top navigation bar.
    1. Click **Manage Organization**.
    1. Click the **Roles** tab.
    1. Click the **Delete** icon next to the role you want to delete.
    1. Click **Delete**.
        The role is removed from the list. Users and groups that were assigned this role lose the associated permissions.

=== "Vultr API"

    1. Send a `GET` request to the [**List Roles** endpoint](https://www.vultr.com/api/#tag/iam/operation/list-iam-roles) 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.

    1. Send a `DELETE` request to the [**Delete Role** endpoint](https://www.vultr.com/api/#tag/iam/operation/delete-iam-role) 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.

    1. Send a `GET` request to the [**List Roles** endpoint](https://www.vultr.com/api/#tag/iam/operation/list-iam-roles) 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.

=== "Terraform"

    1. Ensure the [Vultr Terraform provider](https://registry.terraform.io/providers/vultr/vultr/latest/docs) is configured in your Terraform project.

    1. 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`.