Root Cause Analysis: - FastAPI cannot distinguish between endpoint Query params and Dependency Query params - When endpoint has Query(...), dependency Query(default=None, name='token') is ignored - Token went to endpoint, not to require_auth_flexible Solution: - Renamed internal parameter to auth_token with alias='token' - Now FastAPI correctly routes ?token=XXX to the dependency - Uses Query(default=None, alias='token') to maintain API compatibility Testing: - Header auth: Works (X-Auth-Token) - Query auth: Now works (?token=XXX) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>