info:
  name: Update Email
  type: http
  seq: 2
http:
  method: PUT
  url: '{{base_url}}/api/auth/email'
  auth: inherit
  body:
    type: json

docs: |-
  ## Update Email
  
    Updates the authenticated user's email address.
  
    **Method:** PUT
  
     **Endpoint:** /api/auth/email
  
    **Authentication:** Required
  
    **Request Body:**
    - `email` (string, required): New email address (must be valid email format)
  
    **Response:**
    - `message` (string): Success message
  
    **Status Codes:**
    - 200: Success
    - 400: Invalid email format
    - 401: Unauthorized
    - 409: Email already taken