/v1/me/mfa/totp/{factor_id}/confirmAuthTurn on a pending authenticator app
Checks one current code. When this is the account's first factor the answer carries 10 recovery codes, exactly once. Not idempotent and takes no `Idempotency-Key`: the answer carries a secret (an authenticator seed, a ceremony challenge or recovery codes) that a replay cache must not hold.
Path parameters
factor_id*string · uuidFactor id.
Request body
code*stringThe 6-digit code from the app or the email.
Response · 200
factor*objectid*string · uuidFactor id; send it back as `factor_id`.
type*objectKind of factor. Clients treat this as an open enum.
label*stringName the account holder gave it (or a default).
email_maskedstringEmail factors: the masked destination, e.g. `c***h@g***l.com`.
status*objectOnly active factors are listed.
created_at*string · date-timeWhen the factor was turned on.
last_used_at*string · date-timeLast time it completed a second step.
recovery_codesarrayOnly when this was the account's FIRST factor: 10 single-use recovery codes, returned exactly once.
Example
Request
POST https://api.platform-auth.productcraft.co/v1/me/mfa/totp/{factor_id}/confirm
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
{
"code": "string"
}Response
{
"factor": {
"id": "00000000-0000-0000-0000-000000000000",
"type": {},
"label": "string",
"email_masked": "string",
"status": {},
"created_at": "2026-01-01T00:00:00.000Z",
"last_used_at": "2026-01-01T00:00:00.000Z"
},
"recovery_codes": [
"string"
]
}