Get user, update profile, change password, upload avatar, and password reset flow

Profile & Password

Get Current User

Get authenticated user details.

GET /api/v1/auth/me

Headers: Authorization: Bearer {token} Response: 200 OK

{
  "success": true,
  "message": "User details retrieved",
  "data": {
    "id": 1,
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+91 9876543210",
    "avatar_url": "https://domain.com/storage/avatars/user1.jpg",
    "email_verified_at": "2026-02-08T18:00:00+00:00",
    "created_at": "2026-02-08T18:00:00+00:00"
  }
}

Update Profile

Update user profile information.

PUT /api/v1/auth/profile

Headers: Authorization: Bearer {token} Request Body:

{
  "name": "John Smith",
  "phone": "+91 9876543211",
  "date_of_birth": "1990-05-15",
  "gender": "male"
}

Response: 200 OK

Change Password

Change account password.

POST /api/v1/auth/password/change

Headers: Authorization: Bearer {token} Request Body:

{
  "current_password": "oldpassword123",
  "password": "newpassword123",
  "password_confirmation": "newpassword123"
}

Response: 200 OK

Upload Avatar

Upload profile picture.

POST /api/v1/auth/avatar

Headers:

Authorization: Bearer {token}
Content-Type: multipart/form-data

Request Body:

Field	Type	Description
avatar	File	Image file (max 2MB)

Response: 200 OK

{
  "success": true,
  "message": "Avatar uploaded successfully",
  "data": {
    "avatar_url": "https://domain.com/storage/avatars/user1.jpg"
  }
}

Forgot Password

Request password reset email.

POST /api/v1/auth/password/forgot

Request Body:

{
  "email": "john@example.com"
}

Reset Password

Reset password with token.

POST /api/v1/auth/password/reset

Request Body:

{
  "email": "john@example.com",
  "token": "reset-token-from-email",
  "password": "newpassword123",
  "password_confirmation": "newpassword123"
}