This endpoint allows administrators to permanently remove a user account from the system. Always ensure proper authorization and data validation before invoking this operation.

📌 Endpoint Details

  • Method: DELETE
  • Path: /api/v1/users/{user_id}
  • Description: Deletes a specified user by ID. Irreversible action - use with caution.

📋 Request Parameters

Parameter Type Required Description
user_id string ✅ Yes Unique identifier of the user to be deleted

📦 Response Examples

HTTP/1.1 204 No Content

✅ Success - User account deleted successfully

HTTP/1.1 404 Not Found

❌ User not found

HTTP/1.1 401 Unauthorized

🔐 Invalid or missing authentication token

⚠️ Security Recommendations

  • 🔒 Use HTTPS to protect sensitive data
  • 🛡️ Validate user permissions before deletion
  • 📝 Log the action for audit purposes
  • 🧠 Consider soft-deletion if needed

For detailed implementation guides, check our User Management Documentation 📘

delete_user_api

Always verify the user's role and ensure compliance with data protection regulations before proceeding.