Two-Factor Auth

Endpoints related to setting up two-factor authorization on a Cycle account.

Get Two-Factor Auth Setup

Gets the barcode and secret required for setting up two-factor authentication for the Account.

SecuritybearerAuth and hubAuth
Responses
200

Returns necessary information for configuring two-factor auth for the Account.

default

General error response from the platform

get/v1/account/2fa/setup
Response samples
application/json
{
  • "data": {
    }
}

Disable Two-Factor Auth

Disables two-factor auth for the account.

SecuritybearerAuth and hubAuth
Request
Request Body schema: application/json
token
required
string

A valid existing two-factor auth token, for verification.

Responses
200

Returns the Account.

default

General error response from the platform

post/v1/account/2fa/disable
Request samples
application/json
{
  • "token": "string"
}
Response samples
application/json
{
  • "data": {
    }
}

Recover Two-Factor Auth

Returns a new two-factor auth setup to reset the Account's two-factor auth.

SecuritybearerAuth and hubAuth
Request
Request Body schema: application/json
email
required
string

The user's email

password
required
string
recovery_codes
required
Array of strings
token
string
Responses
200

Returns details for setting up two-factor auth.

default

General error response from the platform

post/v1/account/2fa/recover
Request samples
application/json
{
  • "email": "string",
  • "password": "string",
  • "recovery_codes": [
    ],
  • "token": "string"
}
Response samples
application/json
{
  • "data": {
    }
}