Create tfa login

Log a user in by verifying a given 2FA code and tfa_method Requirements: - tfa_method - the 2FA method being used (“sms” or “totp” or “email”) - code - the 2FA code provided by the user to verify - tfa_secret - the secret token provided to the user in the previous step of auth either from the UI or CLI (if using SMS) - (optional) backup_code - a one time use backup code that can be used if the user is unable to access their normal 2FA method UI/Client: Called by a user using a valid tfa_secret that was created after passing the first step of auth (username/password) CLI flow: The user calls this endpoint using their API Key as a Bearer token and a tfa_secret only if using SMS 2FA On Success: A new 2FA Session API Key that expires in 24 hours will be created for the user (and returned in the response if called from CLI) An audit log record will be created for the successful 2FA login

POST /api/v0/tfa

Create tfa login

cURL

curl --request POST \
  --url https://console.vast.ai/api/v0/tfa/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tfa_method_id": "<string>",
  "code": "<string>",
  "secret": "<string>",
  "tfa_method": "<string>",
  "backup_code": "<string>",
  "admin": "<string>"
}
'

200

{
  "success": true,
  "msg": "Operation completed successfully"
}

Authorizations

Authorization · string · header · required

API key must be provided in the Authorization header

Body

application/json

tfa_method_id · string

The tfa method id

code · string

The code

secret · string

The secret

tfa_method · string

The tfa method

backup_code · string

The backup code

admin · string

The admin

Response

200

application/json

Successful response

success · boolean

Example:

true

msg · string

Example:

"Operation completed successfully"