Authenticate with TOTP

Changed on Nov 12, 2026

Complete authentication using a Time-based One-Time Password (TOTP) after initial password verification.

post/accounts/auth-with-totp

Request

Base URL
https://api.quiva.ai
Auth
none required
TypeScript
https://skmtc.dev/quivaworks/apis/quiva-ai-gateway/docs/accounts/auth-with-totp/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

tokenstring required

MFA token received from password authentication

codestring required

6-digit TOTP code from authenticator app

emailstring email

User's email address (optional when authenticated)

remember_deviceboolean

Remember this device for 30 days. The response then carries device_token.

Example request

{
  "token": "mfa_token_abcdef1234567890",
  "code": "123456"
}

Response

Authentication successful

Changes

Nov 12, 2026700eb1ace61a Revision changes
- info
  added the new optional request property
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
Jun 12, 20254979dfd00eda Revision changes
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  added the required property to the response with the status

Operation history