Latest Content

How to Update a Policy

Updated on 08 April, 2026

Update an existing IAM policy on Vultr. Modify the policy document, name, or description to adjust permission rules for associated users, groups, and roles.

Updating a policy allows you to change its name, description, or permission rules defined in the policy document. This is useful when you need to expand or restrict the actions and resources covered by the policy.

This guide explains how to update 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 name of the policy you want to update.
  6. Click the Edit icon in the Details section to update the name or description, then click Save Changes.
  7. Click the Edit icon in the Policy Details section to modify the permission rules. Update the Allow or Deny settings for each action as needed, then click Save Changes.

  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 update.

  2. Send a GET request to the Read Policy endpoint to retrieve the current policy details. Replace {policy-id} with the id you retrieved in the previous step.

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

  3. Send a PUT request to the Update Policy endpoint to update the policy. Replace the values with your updated policy details.

    console 
    $ curl "https://api.vultr.com/v2/policies/{policy-id}" \
    -X PUT \
    -H "Authorization: Bearer ${VULTR_API_KEY}" \
    -H "Content-Type: application/json" \
    -d '{
        "name": "NEW-POLICY-NAME",
        "description": "NEW-POLICY-DESCRIPTION",
        "policy_document": {
            "Version": "2026-03-20",
            "Statement": [
                {
                    "Action": [
                        "compute.instance.List",
                        "compute.instance.Read",
                        "compute.instance.Update"
                    ],
                    "Effect": "Allow",
                    "Resource": "*"
                }
            ]
        }
    }'

    A successful update returns an HTTP 202 Accepted response with no response body.

  4. Send a GET request to the Read Policy endpoint to retrieve the updated details.

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

    Verify that the policy details reflect the new values.

Comments