Login

Authenticate with email and password.

POST/auth/login

Authenticate a user and issue a fresh signed session cookie.

Request body:

Request
{
  "email": "person@example.com",
  "password": "super-secret-password"
}

On success:

  • a new session is created
  • the Axum integration sets a signed session cookie
  • the user payload is returned

Common error responses:

  • 401 Unauthorized for invalid credentials
  • 403 Forbidden when login requires verified email and the user is still unverified
Session behavior

Successful login creates a new session record and the Axum integration stores the raw session token in a signed cookie.