---
title: How to Delete a Policy
url: https://docs.vultr.com/platform/iam/policies/how-to-delete-a-policy
description: Delete an IAM policy from your Vultr organization. Remove the policy and its permission rules from all associated users, groups, and roles in the system.
publish_date: 2026-03-24T19:52:07.940383Z
last_updated: 2026-06-01T21:19:32.359892Z
---

Deleting a policy removes it from your organization. Users, groups, and roles that had the policy attached lose the permissions defined by it. The policy can be restored using the Restore Policy endpoint if you have its `id`.

> [!NOTE]
> Deleting a policy does not affect the users, groups, or roles it was attached to. It only removes the permission rules defined by the policy.

Follow this guide to delete a policy 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 **Permission Policies** tab.
    1. Click the **Delete** icon next to the policy you want to delete.
    1. Click **Delete** to confirm.

        The policy is removed from the list.

=== "Vultr API"

    1. Send a `GET` request to the [**List Policies** endpoint](https://www.vultr.com/api/#tag/iam/operation/list-iam-policies) to retrieve all policies in your organization.

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

        Note the `id` of the policy you want to delete.

    1. Send a `DELETE` request to the [**Delete Policy** endpoint](https://www.vultr.com/api/#tag/iam/operation/delete-iam-policy) to delete the policy. Replace `{policy-id}` with the id of the policy you want to delete.

        ```console
        $ curl "https://api.vultr.com/v2/policies/{policy-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 Policies** endpoint](https://www.vultr.com/api/#tag/iam/operation/list-iam-policies) to retrieve all policies.

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

        Verify that the deleted policy 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 policy resource. Replace `my_policy` with the resource label used in your configuration.

        ```console
        $ terraform destroy -target=vultr_organization_policy.my_policy
        ```

        Alternatively, remove the `vultr_organization_policy` block from your configuration and run:

        ```console
        $ terraform apply
        ```

        Verify that the output shows `vultr_organization_policy.my_policy: Destruction complete`.