Auth

Get the unused TOTP recovery-code count after reauthentication

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

Request

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

Request body

$schemastring uri

A URL to the JSON Schema for this object.

current_passwordstring required

Current password for re-authentication

reauth_grantstring

One-time action-bound reauthentication grant

Example request

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

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

remaininginteger required

Number of unused active MFA recovery codes

Example response

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

Changes

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