---
title: How to Restore a Deleted Role
url: https://docs.vultr.com/platform/iam/roles/how-to-restore-a-deleted-role
description: Restore a previously deleted IAM role on Vultr. Recover the role and its policy attachments to reassign it to users and groups in your organization's IAM.
publish_date: 2026-03-24T19:52:44.612050Z
last_updated: 2026-06-01T21:29:50.452730Z
---

Restoring a deleted role reinstates it along with its previous configuration. This is useful when a role was deleted by mistake or when you need to recover access configurations that were managed under that role.

> [!NOTE]
> To restore a deleted role, you must have the role's `id`.

This guide explains how to restore a previously deleted role using the Vultr API.

1. Send a `PATCH` request to the [**Restore Role** endpoint](https://www.vultr.com/api/#tag/iam/operation/restore-iam-role) to restore the deleted role. Replace `{role-id}` with the id of the deleted role.

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

1. Send a `GET` request to the [**Read Role** endpoint](https://www.vultr.com/api/#tag/iam/operation/get-iam-role) to retrieve the role details.

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

    Verify that the role details are intact.