Auth
Login as a local user
Verify the user's email + password. Returns one of two shapes:
- kind: "session" — the user has no active MFA. The body carries a full session JWT (mfa_satisfied=false). Backward- compatible with the pre-MFA shape; existing clients can ignore kind.
- kind: "mfa_required" — the user has at least one active MFA method. The body carries a 5-minute mfa_challenge_token which must be exchanged at /auth/mfa/verify-login for a real session JWT.
See docs/auth/USER_LOGIN.md and the MFA roadmap "Two-step login" section.
post/login
Request
- Base URL: http://localhost:8000
- URL: http://localhost:8000/login
- Auth: none declared
Headers
API-Version'1'
Major API version. Omit or send 1 for the current v1 surface. Retired operations use RFC 9745 Deprecation and RFC 8594 Sunset headers.
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.