Platform API reference

Platform API · Me

post/v1/me/mfa/webauthn/{factor_id}/confirmAuth

Turn on a pending passkey

Verifies the credential `navigator.credentials.create()` produced for this factor's challenge. Browser-only. 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 · uuid

Factor id.

Request body

credential*object

The `PublicKeyCredential` from `navigator.credentials.create()`, ArrayBuffers base64url-encoded: `{ id, raw_id, type, response: { clientDataJSON, attestationObject, transports? } }` (member names verbatim).

Response · 200

factor*object
id*string · uuid

Factor id; send it back as `factor_id`.

type*object

Kind of factor. Clients treat this as an open enum.

label*string

Name the account holder gave it (or a default).

email_maskedstring

Email factors: the masked destination, e.g. `c***h@g***l.com`.

status*object

Only active factors are listed.

created_at*string · date-time

When the factor was turned on.

last_used_at*string · date-time

Last time it completed a second step.

recovery_codesarray

Only 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/webauthn/{factor_id}/confirm
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "credential": {}
}

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"
  ]
}