mem0ai/mem0 · error · HTTPException
Authentication required.
Error message
Authentication required.
What it means
Error "Authentication required." thrown in mem0ai/mem0.
Source
Thrown at server/auth.py:189
raise HTTPException(
status_code=401,
detail="Authentication required. Provide a Bearer token or X-API-Key header.",
headers={"WWW-Authenticate": "Bearer"},
)
async def require_auth(
request: Request,
user: User | None = Depends(verify_auth),
) -> User:
"""Like verify_auth but guarantees a non-None User. Use for endpoints that require auth."""
if user is None:
if getattr(request.state, "auth_type", "none") in {"admin_api_key", "disabled"}:
with SessionLocal() as db:
default_user = _get_default_user(db)
if default_user is not None:
return default_user
raise HTTPException(status_code=401, detail="Authentication required.")
return user
_BOOTSTRAP_ADMIN = User(
id=uuid.UUID(int=0), name="admin_api_key", email="", password_hash="", role="admin", created_at=datetime.min.replace(tzinfo=timezone.utc),
)
async def require_admin(
request: Request,
user: User | None = Depends(verify_auth),
) -> User:
"""Like require_auth but also enforces admin role.
ADMIN_API_KEY and AUTH_DISABLED callers are treated as admin even when
the users table is empty (fresh-deploy bootstrap).
"""
auth_type = getattr(request.state, "auth_type", "none")View on GitHub (pinned to 001c235229)
Solutions
- Authenticate first (login or API key) before calling this endpoint.
When it happens
Trigger: Thrown at server/auth.py:189 when the library encounters an invalid state.
Common situations: See trigger scenarios.
Understand the failure class
- Authentication and authorization failures — expired tokens, bad credentials, and missing scopes.
AI-assisted analysis of mem0ai/mem0@001c235229 (2026-08-15).
Data as JSON: /api/errors/7832427725b8efb2.
Report an issue: GitHub.