Latest Content

How to Update a Group

Updated on 08 April, 2026

Update an existing IAM group in your Vultr organization. Modify the group name or description through the Vultr API or Console to reflect current team roles.

Updating a group allows you to change its display name or description. This is useful when a group's purpose evolves or when you need to correct naming conventions across your organization.

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

This guide explains how to update 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 update.

  6. Click the Edit icon next to the group details.

  7. In the Edit Group panel, update the Group Name and Group Description.

  8. Click Save Changes.

    The group details are updated.

  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 update.

  2. Send a GET request to the Read Group endpoint to retrieve the current group details. Replace {group-id} with the id you retrieved in the previous step.

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

  3. Send a PUT request to the Update Group endpoint to update the group. Replace NEW-GROUP-NAME and NEW-GROUP-DESCRIPTION with the updated values.

    console 
    $ curl "https://api.vultr.com/v2/groups/{group-id}" \
    -X PUT \
    -H "Authorization: Bearer ${VULTR_API_KEY}" \
    -H "Content-Type: application/json" \
    -d '{
        "display_name": "NEW-GROUP-NAME",
        "description": "NEW-GROUP-DESCRIPTION"
    }'

    The response confirms the group has been updated.

  4. Send a GET request to the Read Group endpoint to retrieve the updated details.

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

    Verify that the display_name and description fields reflect the new values.

Comments