Browse the API reference

Passkey Registration Options

post/v1/auth/passkeys/register/options

Part of Auth.

Begin a passkey enrollment ceremony. The settings lane requires a fresh re-auth proof (password or assertion); the forced lane presents its enrollment token.

Authentication

This operation does not require an API key.

Request body

Required, application/json.

Field	Type	Description
`mfa_token`optional	string	Enrollment token from a login that returned mfa_enrollment_required
`password`optional	string	Current password — settings-lane re-authentication
`assertion`optional	object	Fresh WebAuthn assertion from the re-auth ceremony (settings lane)

Example request

curl

curl -X POST "https://api.robosystems.ai/v1/auth/passkeys/register/options" \
  -H "Content-Type: application/json" \
  -d '{
  "mfa_token": "string",
  "password": "string",
  "assertion": {}
}'

Responses

200 Successful Response

Field	Type	Description
`options`required	object	PublicKeyCredential options (browser JSON, opaque)

Status	Meaning
400	Invalid request
401	Authentication required
422	Validation Error
429	Rate limit exceeded
500	Internal server error