Regenerate recovery codes

POST

/api/v1/mfa/recovery

curl --request POST \
  --url https://osctrl.net/api/v1/mfa/recovery \
  --header 'Content-Type: application/json' \
  --data '{ "password": "example" }'

Invalidates the existing recovery codes and returns a new set.

Request Body^required

Request body

Media typeapplication/json

object

password

string

Example^generated

{
  "password": "example"
}

Responses

200

OK

Media typeapplication/json

object

recovery_codes

Array<string>

Example^generated

{
  "recovery_codes": [
    "example"
  ]
}

401

Unauthorized

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

403

Forbidden

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

409

Conflict

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

500

Internal server error

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}