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

OR

Changes

No recorded changes to this operation across all 1 revision of this API.