HIVE Docs
Explore HIVE

mfa_enrollment_required

Multi-factor enrolment required

Used asTop-level code, HTTP 403.
Retryableno
SinceAPI version 2026-11-01

Messages#

LanguageTitledetail template
enMulti-factor enrolment requiredMulti-factor authentication must be set up first.
deEinrichtung der Mehrfaktor-Authentifizierung erforderlichDie Mehrfaktor-Authentifizierung muss zuerst eingerichtet werden.

title is fixed English text and never varies per occurrence; detail follows Accept-Language and is for people only. Clients switch on code (and detail_code or failed_preconditions[].code), never on detail. A client that does not know a code falls back to the HTTP status class.

Example#

JSON
{
  "type": "https://docs.hive.clerktree.com/errors/mfa_enrollment_required",
  "title": "Multi-factor enrolment required",
  "status": 403,
  "detail": "Multi-factor authentication must be set up first.",
  "instance": "/v1/assets",
  "code": "mfa_enrollment_required",
  "request_id": "req_01m71xxqhkf9avn6dq2sfgzgym",
  "retryable": false
}