Sign in
auth

Replace the recovery-code batch; returns the codes once.

Changed on

An account-security mutation proved by the confirmed TOTP code where one stands, else the password (recovery codes never authorize their own regeneration). Replaces the batch atomically and returns the plaintext codes exactly once. Reissues the acting session; the reissued token is returned and MUST replace the old one.

post/api/v1/auth/recovery-codes/regenerate

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v1/auth/recovery-codes/regenerate
  • Auth: HTTP bearer

Request body

proofstring required

The account-security proof: the confirmed TOTP code where one stands, else the password.

Response

New batch. The codes are displayed once and never again.

recovery_codesstring[] required

The plaintext single-use codes, displayed once and never again.

Changes

  • 54b2780eec85Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • f84a1cd8a05aRevision changes
    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new payload_too_large enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status

    • warning

      added the new unprocessable enum value to the / response property for the response status