Latest Content

How to Delete a Policy

Updated on 08 April, 2026

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.

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.

This guide explains how to delete a policy 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 Permission Policies tab.

  5. Click the Delete icon next to the policy you want to delete.

  6. Click Delete to confirm.

    The policy is removed from the list.

  1. Send a GET request to the List Policies endpoint 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.

  2. Send a DELETE request to the Delete Policy endpoint 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.

  3. Send a GET request to the List Policies endpoint 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.

Comments