Auth

Replace old recovery codes after the new set is saved

post/auth/security/totp/recovery-codes/activate

Request

  • Base URL: https://app.openpo.st/api/v1
  • URL: https://app.openpo.st/api/v1/auth/security/totp/recovery-codes/activate
  • 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

Recovery-code challenge ID

recovery_codes_savedboolean required

Explicit acknowledgement that the one-time recovery codes were saved

Example request

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

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

methodsstring[] nullable required

Currently available MFA methods

totp_enabledboolean required

Whether authenticator-based 2FA is enabled

Example response

{
  "$schema": "https://example.com/api/v1/schemas/SecurityStatusOutputBody.json",
  "user": {
    "$schema": "https://example.com/api/v1/schemas/UserProfile.json"
  }
}

Changes

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