Authentication

Log in (get a session token)

Exchanges email + password for a 24h JWT session token and a refresh token. If MFA is enrolled, returns { mfaRequired: true, mfaToken } instead — complete the login with POST /auth/mfa/login. For scripts and AI agents prefer a sat_live_ API key over this flow.

post/auth/login

Request

  • Base URL: https://saturnsql.com/api
  • URL: https://saturnsql.com/api/auth/login
  • Auth: none required

Request body

emailstring required
passwordstring required

Response

Authenticated (or MFA challenge)

tokenstring required

JWT session token (24h). Send as Authorization: Bearer <token>.

refreshTokenstring required

Long-lived refresh token (30d) for POST /auth/refresh.

selectedCompanyIdstring
mustChangePasswordboolean

Changes

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