Latest Content

How to List Users Assigned to a Role

Updated on 08 April, 2026

List all users assigned to a specific IAM role on Vultr. View which users directly inherit the permissions defined by the role's attached policies via the API.

Listing users assigned to a role allows you to see which users have the permissions defined by that role. This is useful for auditing access, reviewing role membership, and identifying users affected by role changes.

This guide explains how to list users assigned 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 you want to inspect.

  6. Expand the Attached Entities section.

    The table displays all users and groups attached to this role, including their name, type, and status.

  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 for which you want to list users.

  2. Send a GET request to the List Users with Role endpoint to retrieve all users assigned to the role. Replace {role-id} with the id of the role.

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

    The response contains the requested resources.

Comments