Latest Content

How to List Roles and Policies Attached to a Group

Updated on 08 April, 2026

List all roles and policies attached to a specific IAM group on Vultr. Review the permissions inherited by group members through the Vultr IAM API endpoint.

Listing the roles and policies attached to a group allows you to review the permissions that all members of the group inherit. The API provides visibility into directly assigned permissions, those inherited from other sources, and permissions that come from roles attached to the group.

Note
You must be the organization's root user or have iam.group.* permissions assigned to perform this action.

This guide explains how to list roles and policies attached to a group using the Vultr Console or 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 Groups tab.

  5. Click the name of the group you want to inspect.

    The group detail page displays the Roles and Members sections, showing all roles attached to the group and all users who are members. To view directly attached policies, navigate to the Permission Policies tab, select the policy, and view the group under Attached Entities.

Send a GET request to the List Groups endpoint to retrieve all groups in your organization.

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

Note the id of the group for which you want to list roles and policies.

List Roles

Send a GET request to the List Group Roles endpoint to retrieve all roles attached to the group. Replace {group-id} with the id of the group.

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

List Policies

Send a GET request to the List Group Policies endpoint to retrieve all policies attached to the group.

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

The response contains the requested resources.

Comments