Skip to main content
Sign In
Authenticates an existing user by email and password. Returns an access token, refresh token, and the user’s profile.

Body Parameters

string
required
User’s registered email address.
string
required
User’s password.

Response

boolean
true on successful authentication.
string
Short-lived JWT access token. Expires in 30 minutes.
string
Long-lived JWT refresh token. Expires in 30 days. Use it to request a new access token when the current one expires.
object
The authenticated user’s profile.

Error Responses

The same answer for an email with no account, an account with no password (e.g. one created through OAuth), and a wrong password, so sign-in never reveals whether an email has an account. To offer “create an account” or “sign in with Google” after a failure, show those options alongside the error rather than choosing between them.
A missing or non-string email or password. Sign-in is the one auth route whose body validation reports auth/invalid-credentials rather than auth/invalid-body, so this code has two statuses: branch on the status to tell “fix your request” (400) from “these credentials are wrong” (401).
Rate limit: 25 requests per 5 minutes per IP. Exceeding it returns 429 with the plain-text message Too many sign in attempts, please wait 5 minutes and no code.

See Also