Skip to Content

You are viewing a beta version of Clerk Docs

Visit the latest docs

Clerk Docs

Ctrl + K

Go to clerk.com

`deleteUser()`

Deletes a User given a valid ID.


function deleteUser: (userId: string) => Promise<User>;

`deleteUser()` parameters

Name	Type	Description
`userId`	`string`	The ID of the user to delete.

`deleteUser()` example


const userId = 'user_2b8lKxzUgn5M1hsjaTW1mcjc0iB';
 
const response = await clerkClient.users.deleteUser(userId);
 
console.log(response);
/* 
_DeletedObject {
  object: 'user',
  id: 'user_2b8kQleSRNmcOSCdJ1Y8pSRr4mK',
  slug: null,
  deleted: true
}
*/

Backend API (BAPI) endpoint

This method in the SDK is a wrapper around the BAPI endpoint DELETE/users/{user_id}. See the BAPI reference(opens in a new tab) for more details.

Last updated on August 16, 2023