Goldmine
Two Factor

Begin a step-up re-verification

POST
/accounts.v1.Accounts/BeginStepUp

Starts a fresh two-factor re-verification for the signed-in user ahead of a sensitive action. Returns a challenge ID and the methods available to complete it.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/accounts.v1.Accounts/BeginStepUp" \  -H "Content-Type: application/json" \  -d '{}'
{
  "challengeId": "chl_8f3a2b1c9d4e",
  "allowedMethods": [
    "TWO_FACTOR_METHOD_EMAIL",
    "TWO_FACTOR_METHOD_TOTP"
  ]
}

{
  "code": "failed_precondition",
  "message": "The request cannot be carried out in the current system state."
}

{
  "code": "unauthenticated",
  "message": "The request lacks a valid API key in the Authorization header."
}
{
  "code": "permission_denied",
  "message": "The API key is not allowed to perform this action on this workspace."
}
{
  "code": "resource_exhausted",
  "message": "The request was rate limited. Slow down and retry later."
}
{
  "code": "internal",
  "message": "An internal server error occurred."
}