Overview
POST/account/mfa/webauthn/register/optionsmfa

Begin passkey/security-key registration → ceremony options + challenge token

Create a record in options.

Auth: bearerAuth — calls run as the authenticated user.

Request body

application/json · optional

  • kind"passkey" | "security_key"
Example
{
  "kind": "passkey"
}
Responses
200

Creation options + signed challenge token

  • optionsobject

    PublicKeyCredentialCreationOptionsJSON

  • tokenstring

    Signed registration challenge token

Example
{
  "options": {},
  "token": "string"
}
401

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
422

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
Code examples
cURL
curl -X POST "https://api.agenticdeveloperhub.com/account/mfa/webauthn/register/options" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "passkey"
}'
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/account/mfa/webauthn/register/options", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"kind\": \"passkey\"\n}",
});
const data = await res.json();