Skip to main content

Delete Current User Information

DELETE 
/auth/v1/user/me

API Description​

Delete current user information, requires sending a verification code via the Reauthenticate API for secondary verification before execution. This operation will permanently delete the user account and related data, please use with caution.

Features​

  • Permanently delete current user account
  • Requires verification code from reauthenticate API for secondary verification to ensure security
  • Cannot be recovered after deletion, use with caution
  • Supports both soft delete and hard delete modes

Input Requirements​

Required Parameters​

  • Authorization: Current logged-in user's access_token (required, Bearer format)
  • verify_code: Verification code (required, the code sent to user's phone or email via Reauthenticate API)
  • client_id: Client ID corresponding to the application (optional, defaults to environment ID)
  • x-device-id: Device ID (optional, current logged-in device ID)

Request Body Parameters​

  • No request body parameters

Prerequisites​

  • User must be logged in and hold valid access_token
  • Must send verification code via Reauthenticate API and complete verification
  • Verification code valid for 300 seconds (5 minutes)
  • User confirms to delete their own account

Output Description​

Successful Response​

  • Returns empty object, indicating successful deletion

Request Example​

Delete User Request Example​

DELETE /auth/v1/user/me?verify_code=121688
Authorization: Bearer your_access_token
Content-Type: application/json

Response Examples​

Delete Success Response​

{}

Verification Token Invalid Response​

{
  "error": "permission_denied",
  "error_code": 7,
  "error_description": "bad verification token"
}

User Not Found Response​

{
  "error": "user_not_found",
  "error_code": 4004,
  "error_description": "User does not exist or has been deleted"
}

Usage Flow​

1. Initiate Reauthentication​

  • Call Reauthenticate API to send verification code
  • Choose SMS or email method to receive verification code

2. User Receives Verification Code​

  • User checks verification code in phone or email
  • Verification code valid for 300 seconds (5 minutes)

3. Confirm Deletion​

  • Frontend should display confirmation dialog
  • User confirms deletion operation

4. Execute Deletion​

  • Call this API to delete user
  • Pass verify_code (the verification code received by user) for secondary verification

5. Clean Client Data​

  • Clean local storage after successful deletion
  • Redirect to login page

Key Characteristics​

Security​

  • Requires verification code secondary verification
  • Prevents accidental account deletion
  • Operation logs recorded for audit

Data Cleanup​

  • Delete user basic information
  • Clean user associated data
  • Retain operation log records

Error Handling​

Common Error Scenarios​

  • Verification code expired: Prompt user to resend verification code
  • Verification code incorrect: Check if verification code is correct
  • Network exception: Retry mechanism
  • Server error: Display friendly error message

Request​

Responses​

A successful response.

Response Headers