Profile

Create Two Factor Secret

post
https://api.linode.com/v4/profile/tfa-enable

Generates a Two Factor secret for your User. TFA will not be enabled until you have successfully confirmed the code you were given with tfa-enable-confirm (see below). Once enabled, logins from untrusted computers will be required to provide a TFA code before they are successful.

Authorizations

Personal Access Token
OAuth: ( account:read_write)

Request Samples

curl -H "Content-Type: application/json" \
    -H "Authorization: Bearer $TOKEN" \
    -X POST \
    https://api.linode.com/v4/profile/tfa-enable

Response Samples

{
  "secret": "5FXX6KLACOC33GTC",
  "expiry": "2018-03-01T00:01:01.000Z"
}

Responses

200: Two Factor secret generated

secret
string

Your Two Factor secret. This is used to generate time-based two factor codes required for logging in. Doing this will be required to confirm TFA an actually enable it.

expiry
string <date-time>

When this Two Factor secret expires.

default: Error

errors
array of objects
reason
string

What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.

field
string

The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.