Regenerate backup codes

POST

/api/mfa/backup-codes/regenerate

curl --request POST \
  --url http://localhost:3001/api/mfa/backup-codes/regenerate \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "code": "example" }'

• Local development
• Production

Generate new backup codes for MFA recovery. Requires TOTP verification. Old backup codes will be invalidated.

Authorizations

• BearerAuth

Request Body^required

Regenerate backup codes request

Media typeapplication/json

object

code

Current TOTP code

string

Example^generated

{
  "code": "example"
}

Responses

200

OK

Media typeapplication/json

object

backup_codes

12 new codes (invalidates old ones)

Array<string>

message

string

success

boolean

Example^generated

{
  "backup_codes": [
    "example"
  ],
  "message": "example",
  "success": true
}

400

Bad Request

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}

401

Unauthorized

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}

500

Internal Server Error

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}

503

Service Unavailable

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}