How to Remove a User from a Group

Updated on 08 April, 2026

Remove a user from an IAM group on Vultr. The user loses all roles and policies inherited from the group while retaining any directly assigned permissions.


Removing a user from a group revokes any roles and policies they inherited through that group. The user's account is not affected, and they retain any permissions assigned to them directly or through other groups.

Note
Removing a user from a group does not delete their account or affect their membership in other groups. It only removes the association between the user and this specific group. You must be the organization's root user or have iam.group.* permissions assigned to perform this action.

This guide explains how to remove a user from 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 from which you want to remove the user.

  6. In the Members section, locate the user and click the - icon next to their name.

    The user is removed from the group and loses any permissions inherited through it.

  1. Send a GET request to the List Group Members endpoint to retrieve all members of the group. Replace {group-id} with the id of the group. Note the id of the member you want to remove.

    console
    $ curl "https://api.vultr.com/v2/groups/{group-id}/members" \
        -X GET \
        -H "Authorization: Bearer ${VULTR_API_KEY}"
    
  2. Send a DELETE request to the Delete Group Member endpoint to remove the user from the group. Replace {group-id} with the group id and {member-id} with the id of the member you want to remove.

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

    A successful removal returns an HTTP 204 No Content response with no response body.

  3. Send a GET request to the List Group Members endpoint to retrieve the group members.

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

    Verify that the user no longer appears in the group members list.

Comments