Clerk API (unofficial showcase)
DELETE/users/{user_id}

Delete a user

Deletes the specified user. Use user_id to identify the user to remove; the response confirms whether the deletion occurred.

1 parameter
user_idstringrequired
The unique identifier of the user to delete.

4 status codes
200Returns a deletion object with a `deleted` flag and, when provided, the user's identifier and external ID.
objectstringrequired
idstringoptional
slugstringoptional
deletedbooleanrequired
external_idstringoptional
400Returned when the request is unsuccessful.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
401Returned when authentication is invalid.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional
404Returned when the user resource is not found.
errorsarray<object>required
metaobjectoptional
clerk_trace_idstringoptional

Error handling

A 400 is returned when the request is unsuccessful. A 401 is returned when authentication is invalid, and a 404 is returned when the user resource is not found. The user_id path parameter must identify the user to delete.