Latest Content

How to Attach a Policy to a Role

Updated on 08 April, 2026

Attach an IAM policy to a role on Vultr. Add permission rules to the role that are inherited by all users and groups assigned to it through the IAM system.

Attaching a policy to a role adds the policy's permission rules to the role. All users and groups assigned to the role automatically inherit the permissions defined in the attached policy.

This guide explains how to attach a policy to a role 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 Roles tab.

  5. Click the name of the role to which you want to attach a policy.

  6. In the Permission Policies section, click the + button.

  7. Search for and select the policies you want to attach.

  8. Click Add Permission Policies.

    The selected policies appear in the Permission Policies section.

  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 to which you want to attach a policy.

  2. Send a GET request to the List Policies endpoint to retrieve all available policies.

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

  3. Send a POST request to the Attach Policy to Role endpoint to attach the policy. Replace {role-id} with the role id and {policy-id} with the policy id.

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

    A successful request returns an HTTP 201 Created response.

Comments