<iframe src="https://www.googletagmanager.com/ns.html?id=GTM-M74D8PB" height="0" width="0" style="display:none;visibility:hidden">
Loading
Skip to NavigationSkip to Main Content
How to Delete Okta Users by Using the Rockstar Browser Plugin
Okta Classic Engine
Okta Identity Engine
Okta Integration Network
Overview

The Rockstar Browser Plugin for Okta allows deleting an Okta user by utilizing its API Explorer feature. This feature is essentially a simplified interface for making direct Okta API calls. 

This article details how to delete Okta users by using the Rockstar Browser Plugin.

 

Applies To
  • Okta API
  • Okta Integration Network
  • Delete User
Solution

The Okta user must be deactivated before they can be permanently deleted. The process generally involves two separate API calls. Therefore, the process involves two main steps: 

  1. Deactivate the Okta user
  2. Delete the deactivated Okta user

 

Deactivate the Okta user

  1. In the Okta Admin Console, go to Directory > People and select the user that should be deleted.
  2. Click the Rockstar plugin icon in the browser toolbar, then click API Explorer.
  3. Configure the Deactivation API Call:
    • Set the HTTP Method dropdown to POST.
    • Select the URL endpoint: /api/v1/users/${userId}/lifecycle/deactivate

Endpoint 

      • Replace ${userId} in the URL path with the actual Okta User ID obtained.

API Endpoint

      • Leave the Body field empty.
    1. Click the Send button.
    2. Check the response. A successful deactivation will typically return a 200 OK status code, and the user's status in the Okta console should change from Active to Deactivated.

    "200 ok" successful status

     

     

    Delete the deactivated Okta user

    Once the user is successfully deactivated, you can proceed with the permanent deletion.

    1. If it is not already open, click the Rockstar plugin icon, then API Explorer.
    2. Configure the Deletion API Call:
      • Set the HTTP Method dropdown to DELETE.
      • Select the URL endpoint: /api/v1/users/${userId}

    API Endpoint  

        • Replace ${userId} in the URL path with the same Okta User ID.

        • Leave the Body field empty.
    1. Click the Send button.
    2. A successful deletion will typically return a 204 No Content status code.

    successful deletion 

    1. Refresh the Okta Admin Console's People page. The user should no longer appear in the list (or, if trying to navigate to their profile, a 404 Page Not Found error will appear).

    Error Message

    Loading
    How to Delete Okta Users by Using the Rockstar Browser Plugin