Skip to main content

​
Endpoint

DELETE /users/@me
Permanently delete the currently authenticated user account. This action requires password confirmation and cannot be undone.

​
Headers

​
Authorization
string
required
JWT token obtained from login or registration. Pass the token directly as the header value.

​
Request body

​
password
string
required
Current password of the user account to confirm deletion.

​
Response

Returns 204 No Content on successful deletion with an empty response body.

​
Error codes

​
401 Unauthorized
Authorization token was not provided or is invalid, or the password confirmation was incorrect.This error can occur for two reasons:Invalid token (UnauthorizedException):
  • The Authorization header is missing
  • The JWT token is invalid or expired
  • The JWT token does not correspond to an existing user
Incorrect password (PasswordIncorrectForUserDeletionException):
  • The provided password does not match the user’s current password

​
Example request

curl -X DELETE https://api.example.com/users/@me \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -d '{
    "password": "mySecurePassword123"
  }'

​
Example response

​
Success (204 No Content)

(empty response body)

​
Error (401 Unauthorized - Invalid Token)

{
  "message": "Unauthorized"
}

​
Error (401 Unauthorized - Incorrect Password)

{
  "message": "Password incorrect"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us