Platform API reference

Platform API · Me

post/v1/me/mfa/webauthnAuth

Start adding a passkey

Creates a pending passkey factor and returns `PublicKeyCredentialCreationOptions` for `navigator.credentials.create()` (relying party `productcraft.co`). Browser-only, so not in the SDKs. 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.

Request body

labelstring

Name for the factor (max 64).

Response · 200

factor_id*string · uuid

The pending factor; confirm it with the created credential.

public_key*object

`PublicKeyCredentialCreationOptions` (rp `productcraft.co`) for `navigator.credentials.create({ publicKey })` after decoding base64url fields (`challenge`, `user.id`, `exclude_credentials[].id`).

Example

Request

POST https://api.platform-auth.productcraft.co/v1/me/mfa/webauthn
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "label": "string"
}

Response

{
  "factor_id": "00000000-0000-0000-0000-000000000000",
  "public_key": {}
}