Latest Content

How to Delete a Group

Updated on 08 April, 2026

Delete an IAM group from your Vultr organization. Remove the group and disassociate all member users from the shared roles and policies it previously held.

Deleting a group removes it from your organization. Users who were members of the group are not deleted, but they lose any roles and policies that were assigned through the group.

Note
Deleting a group does not delete its members' accounts. It only removes the group and revokes any permissions that were granted through the group's role and policy assignments. You must be the organization's root user or have iam.group.* permissions assigned to perform this action.

This guide explains how to delete 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. Locate the group you want to delete and click the Delete icon next to it.

  6. In the confirmation dialog, click Delete to confirm.

    The group is removed from the organization.

  1. 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 you want to delete.

  2. Send a DELETE request to the Delete Group endpoint to delete the group. Replace {group-id} with the id of the group you want to delete.

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

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

  3. Send a GET request to the List Groups endpoint to retrieve all groups.

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

    Verify that the deleted group no longer appears in the list.

Comments