---
title: How to Suspend and Unsuspend a User in an Organization
url: https://docs.vultr.com/platform/iam/organizations/how-to-suspend-and-unsuspend-a-user-in-an-organization
description: Suspend or unsuspend a user in your Vultr organization. Temporarily revoke or reinstate a user's access to organizational resources through the IAM API.
publish_date: 2026-03-24T19:52:02.671452Z
last_updated: 2026-04-28T15:29:48.748692Z
---

Suspending a user in an organization temporarily disables their access to all resources, roles, and policies within that organization without removing them. This is useful when you need to revoke access temporarily, such as during an investigation or when a user is on extended leave. Unsuspending the user restores their previous access.

> [!NOTE]
> Suspending a user does not remove them from the organization or delete their account. All their role and policy assignments are preserved and become active again when the user is unsuspended.

This guide explains how to suspend and unsuspend a user in an organization using the Vultr API.

## Suspend a User

1. Send a `GET` request to the [**List Organizations** endpoint](https://www.vultr.com/api/#tag/organizations/operation/list-organizations) to retrieve all organizations associated with your account.

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

    Note the `id` of the organization in which you want to suspend the user.

1. Identify the `user_id` of the user you want to suspend. Follow the steps in [How to List All Users in an Organization](https://docs.vultr.com/platform/iam/organizations/how-to-list-all-users-in-an-organization) to retrieve user IDs.

1. Send a `PUT` request to the [**Suspend User** endpoint](https://www.vultr.com/api/#tag/organizations/operation/suspend-organization-user) to suspend the user. Replace `{organization-id}` with the organization id and `{user-id}` with the id of the user you want to suspend.

    ```console
    $ curl "https://api.vultr.com/v2/organizations/{organization-id}/user/{user-id}/suspend" \
        -X PUT \
        -H "Authorization: Bearer ${VULTR_API_KEY}"
    ```

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

1. Send a `GET` request to the [**List Suspended Users** endpoint](https://www.vultr.com/api/#tag/organizations/operation/list-organization-suspended-users) to retrieve the suspended users list.

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

    Verify that the suspended user appears in the list.

## Unsuspend a User

1. Send a `GET` request to the [**List Suspended Users** endpoint](https://www.vultr.com/api/#tag/organizations/operation/list-organization-suspended-users) to retrieve the list of suspended users in your organization.

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

    Note the `uuid` of the user you want to unsuspend.

1. Send a `PUT` request to the [**Unsuspend User** endpoint](https://www.vultr.com/api/#tag/organizations/operation/unsuspend-organization-user) to restore the user's access. Replace `{organization-id}` with the organization id and `{user-id}` with the `uuid` of the suspended user.

    ```console
    $ curl "https://api.vultr.com/v2/organizations/{organization-id}/user/{user-id}/unsuspend" \
        -X PUT \
        -H "Authorization: Bearer ${VULTR_API_KEY}"
    ```

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

1. Send a `GET` request to the [**List Suspended Users** endpoint](https://www.vultr.com/api/#tag/organizations/operation/list-organization-suspended-users) to retrieve the suspended users list.

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

    Verify that the user no longer appears in the suspended users list.