---
title: How to Remove a User from a Group
url: https://docs.vultr.com/platform/iam/groups/how-to-remove-a-user-from-a-group
description: 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.
publish_date: 2026-03-24T19:52:19.759204Z
last_updated: 2026-04-08T16:02:23.830977Z
---

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"

    1. Log in to the [Vultr Console](https://console.vultr.com).
    1. Click the organization name in the top navigation bar.
    1. Click **Manage Organization**.
    1. Click the **Groups** tab.
    1. Click the name of the group from which you want to remove the user.
    1. 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.

=== "Vultr API"

    1. Send a `GET` request to the [**List Group Members** endpoint](https://www.vultr.com/api/#tag/iam/operation/list-iam-group-members) 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}"
        ```

    1. Send a `DELETE` request to the [**Delete Group Member** endpoint](https://www.vultr.com/api/#tag/iam/operation/remove-iam-group-member) 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.

    1. Send a `GET` request to the [**List Group Members** endpoint](https://www.vultr.com/api/#tag/iam/operation/list-iam-group-members) 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.