v10

latestOpenAPI 3.0.3raw.githubusercontent.com2025-11-287137165.5 KB

Authentication

Authenticate with password

Authenticates a user with their email and password. If MFA is enabled, returns an MFA token that must be used with a subsequent authentication request.

post/accounts/auth-with-password

Request body

accountstring

Account name (optional). If not provided and the user is a root user, their root account will be used.

emailstring email required

User's email address

passwordstring password required

User's password

Example request

{
  "account": "acme",
  "email": "user@example.com",
  "password": "SecurePassword123"
}

Response

Authentication successful or MFA required