WebAuthn
7 endpoints
Generate passkey registration options
Requires authentication
Responses
200Registration options for navigator.credentials.create()
Response fields
dataobjectPOST
/api/v1/auth/webauthn/register/optionscurl -X POST "https://api.uluops.ai/api/v1/auth/webauthn/register/options" \
-H "Authorization: Bearer $ULUOPS_TOKEN"Response
{
"data": {
"options": "...",
"challenge_token": "..."
}
}Verify and store passkey credential
Requires authentication
Request Body
challengeTokenrequiredstringcredentialrequiredobjectRegistrationResponseJSON from navigator.credentials.create()
deviceNamestringResponses
201Credential registered
400Verification failed or duplicate credential
401Missing or invalid authentication
Response fields
dataobjectPOST
/api/v1/auth/webauthn/register/verifycurl -X POST "https://api.uluops.ai/api/v1/auth/webauthn/register/verify" \
-H "Authorization: Bearer $ULUOPS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"challengeToken": "reset-token-abc123",
"credential": "example-value"
}'Response
{
"data": {
"id": "...",
"deviceName": "...",
"createdAt": "2026-01-15T10:30:00Z",
"lastUsedAt": "2026-01-15T10:30:00Z"
}
}Generate passkey authentication options
Request Body
mfaChallengeTokenrequiredstringResponses
200Authentication options for navigator.credentials.get()
Response fields
dataobjectPOST
/api/v1/auth/webauthn/login/optionscurl -X POST "https://api.uluops.ai/api/v1/auth/webauthn/login/options" \
-H "Content-Type: application/json" \
-d '{
"mfaChallengeToken": "reset-token-abc123"
}'Response
{
"data": {
"options": "...",
"challenge_token": "..."
}
}Verify passkey and create session
Request Body
mfaChallengeTokenrequiredstringchallengeTokenrequiredstringcredentialrequiredobjectAuthenticationResponseJSON from navigator.credentials.get()
Responses
200Session created
401Missing or invalid authentication
Response fields
userobjectsessionTokenstringexpiresAtstringdate-timePOST
/api/v1/auth/webauthn/login/verifycurl -X POST "https://api.uluops.ai/api/v1/auth/webauthn/login/verify" \
-H "Content-Type: application/json" \
-d '{
"mfaChallengeToken": "reset-token-abc123",
"challengeToken": "reset-token-abc123",
"credential": "example-value"
}'Response
{
"user": "...",
"sessionToken": "...",
"expiresAt": "2026-01-15T10:30:00Z"
}List registered passkeys
Requires authentication
Responses
200Credential list
Response fields
dataWebAuthnCredential[]countintegerGET
/api/v1/auth/webauthn/credentialscurl -X GET "https://api.uluops.ai/api/v1/auth/webauthn/credentials" \
-H "Authorization: Bearer $ULUOPS_TOKEN"Response
{
"data": [
{
"id": "...",
"deviceName": "...",
"createdAt": "2026-01-15T10:30:00Z",
"lastUsedAt": "2026-01-15T10:30:00Z"
}
],
"count": 0
}Rename a passkey
Requires authentication
Parameters
idrequiredstringpathCredential ID
Request Body
deviceNamerequiredstringResponses
200Credential renamed
404Resource not found
PATCH
/api/v1/auth/webauthn/credentials/{id}curl -X PATCH "https://api.uluops.ai/api/v1/auth/webauthn/credentials/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer $ULUOPS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"deviceName": "example-value"
}'Delete a passkey (requires password confirmation)
Requires authentication
Parameters
idrequiredstringpathCredential ID
Request Body
passwordrequiredstringResponses
200Credential deleted
401Incorrect password
404Resource not found
DELETE
/api/v1/auth/webauthn/credentials/{id}curl -X DELETE "https://api.uluops.ai/api/v1/auth/webauthn/credentials/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer $ULUOPS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"password": "SecurePass123!"
}'