Skip to content
Dashboard
Theme
Theme

Start registering a passkey for an end user (headless)

POST /v1/users/{user}/passkeys/registration_options: Start registering a passkey for an end user (headless).

View Markdown

POST /v1/users/{user}/passkeys/registration_options

For native and server-driven apps. Returns WebAuthn creation options bound to the hosted sign-in relying party (RP ID signin.<domain>). The ceremony is accepted from the sign-in origin and from the environment’s native_app_origins (WebAuthn Level 3 §5.8.1: android:apk-key-hash origins; iOS apps listed as ios:<team>.<bundle> are served in the sign-in host’s webcredentials association and convey the sign-in origin). Expires in 5 minutes.

Scope
users:write
Auth
Secret key (sk_…)
Since
1.0
  • user string Required

  • OhAuthCat-Version string

    Minor version; defaults to the environment’s pin.

Errors share one shape; see the error code catalogue.

curl -X POST \
"https://api.ohauthcat.com/v1/users/usr_01J9Z3K5V7W8X9Y0Z1A2B3C4D5/passkeys/registration_options" \
-H "Authorization: Bearer $OHAUTHCAT_API_KEY"
Response 200
{
"public_key": {}
}