v8

OpenAPI 3.1.02026-08-033623795.0 MB
Users

Create Challenge

Mints the challenge a browser needs to run a WebAuthn ceremony against the authenticated user's own passkeys. A registration challenge enrolls a new passkey; a deletion challenge is bound to the one passkey named by passkey_id and proves the user still holds it. Challenges are single-use and expire 5 minutes after they are issued, so send a fresh Idempotency-Key per ceremony — a replayed key returns the original challenge, which may already have expired. Requires a user session.

post/users/me/passkeys/challenge

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

A unique key that makes this request safe to retry. See Idempotent requests.

Request body

challenge_type'registration' | 'deletion' required

The ceremony this challenge is for.

passkey_idstring

The passkey the ceremony targets, prefixed wcred_. Required when challenge_type is deletion, ignored otherwise.

Response

challenge minted

challengestring required

The challenge to pass to the WebAuthn ceremony, base64url-encoded without padding.