Auth

Confirm TOTP enrollment with a verification code

post/auth/security/totp/confirm

Request

  • Base URL: https://app.openpo.st/api/v1
  • URL: https://app.openpo.st/api/v1/auth/security/totp/confirm
  • Auth: one of:
    • HTTP bearer
    • API key in cookie openpost_session

Request body

$schemastring uri

A URL to the JSON Schema for this object.

challenge_idstring required

TOTP setup challenge ID

codestring required

Six digit authenticator code

Example request

{
  "$schema": "https://example.com/api/v1/schemas/ConfirmTOTPSetupInputBody.json"
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

challenge_idstring required

Expiring challenge that activates this code set after acknowledgement

recovery_codesstring[] nullable required

One-time plaintext recovery codes; these are never returned again

Example response

{
  "$schema": "https://example.com/api/v1/schemas/RecoveryCodeSetOutputBody.json"
}

Changes

No recorded changes to this operation across all 1 revision of this API.