WoyraDocs
Get an API key

Start TOTP enrolment

POST/v1/auth/mfa/enrol

Console · Requires an API key

Returns a fresh secret and an otpauth:// URI to render as a QR code. Nothing is enabled until /v1/auth/mfa/confirm proves the app has it. Two-factor authentication is **mandatory for any account that has ever spent money**: until such an account enrols, every other endpoint answers 403 mfa_required to its console sessions.

Example

curl -X POST https://api.woyra.io/v1/auth/mfa/enrol \
  -H "Authorization: Bearer $WOYRA_KEY"

Response

200 Enrolment material.

FieldTypeDescription
object"mfa_enrolment"
secretstringBase32
uristringotpauth URI for a QR code.

Errors

StatusCodes
400invalid_request, unsupported_version

Also in Console