Submit passkey session
Passkeys
Submit Passkey Session
Submit WebAuthn ceremony data to complete passkey creation or authentication.
Submit passkey session
Submits the WebAuthn authenticator response to complete passkey creation or authentication. Processes ceremony data and executes on-chain transaction to initialize or refresh the passkey.
Only ES256 (algorithm
-7) signatures are supported. The authenticator response must verify user presence.Implementation Flow
1
Complete WebAuthn Ceremony
User completes passkey creation or authentication in hosted UI or custom UI
2
Extract Response
Retrieve the complete authenticator response from the WebAuthn API
3
Submit to API
POST to /passkeys/submit with ceremony type, session key, slot, and response
4
Process Result
Receive passkey_account address and session_key for transaction signing
Related Endpoints
- Create Passkey Session - Initialize passkey creation
- Authorize Passkey Session - Start authentication
- Get Passkey Account - Retrieve passkey details
Authorizations
Your Grid API key from the Grid Dashboard
Headers
Solana network environment (sandbox, devnet, mainnet)
Body
application/json
Available options:
create, auth Grid v1 API SessionKey type that supports backward-compatible deserialization from both raw bytes array (old format) and base58 string (new format). Always serializes to base58 string format.
Required range:
x >= 0Response
Passkey session submitted successfully. If the passkey is a signer on a smart account, smart_account data will be included in the response.