Skip to content

Users

users_users_delete

Soft-delete an end user: the record is retained with `deletedAt` set and disappears from the default list.

Tool

users_users_delete

Soft-delete an end user: the record is retained with `deletedAt` set and disappears from the default list.

Soft-delete an end user: the record is retained with `deletedAt` set and disappears from the default list. This is NOT GDPR erasure — no data is purged, and the user can still be fetched by id.

Behavior

HTTP
DELETE /users/users/:userId

Arguments

NameTypeRequiredDescription
userIdstringThe opaque user id returned by users_users_create or _list.

Response

FieldTypeAlwaysDescription
idstring
namestring
bannedAtstring
erasedAtstring
imageUrlstring
testUserboolean
createdAtstring
deletedAtstring
productIdstring
updatedAtstring
waitlistedboolean
identifiersarray
lockedUntilstring
lastSignInAtstring
requiresResetboolean
publicMetadataobject
unsafeMetadataobject
privateMetadataobject
emailChangeLockedUntilstring

Try it

Soft-delete an end user: the record is retained with `deletedAt` set and disappears from the default list.

When to use

Soft-delete an end user: the record is retained with `deletedAt` set and disappears from the default list. This is NOT GDPR erasure — no data is purged, and the user can still be fetched by id.

Example

Ask your agent something like this:

Soft-delete an end user: the record is retained with `deletedAt` set and disappears from the default list.

The agent will invoke users_users_delete with these arguments:

{
  "userId": "<userId>"
}

Esc

Start typing to search the docs.

navigateselect