Totp Enable

POST

/auth/totp/enable

curl --request POST \
  --url https://example.com/auth/totp/enable \
  --header 'Content-Type: application/json' \
  --data '{ "code": "example" }'

Prove the authenticator works, then switch 2FA on and hand out single-use backup codes — the only time they’re ever shown.

Request Body^required

Media typeapplication/json

TotpEnableRequest

object

code

required

Code

string

>= 6 characters <= 8 characters

Example^generated

{
  "code": "example"
}

Responses

200

Successful Response

Media typeapplication/json

TotpEnableResponse

object

backup_codes

required

Backup Codes

Array<string>

Example^generated

{
  "backup_codes": [
    "example"
  ]
}

422

Validation Error

Media typeapplication/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Example^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}