Registry↗Dashboard↗

WebAuthn

7 endpoints

Generate passkey registration options

Requires authentication
200Registration options for navigator.credentials.create()

Response fields

dataobject
POST/api/v1/auth/webauthn/register/options
curl -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
challengeTokenrequiredstring
credentialrequiredobject

RegistrationResponseJSON from navigator.credentials.create()

deviceNamestring
201Credential registered
400Verification failed or duplicate credential
401Missing or invalid authentication

Response fields

dataobject
POST/api/v1/auth/webauthn/register/verify
curl -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

mfaChallengeTokenrequiredstring
200Authentication options for navigator.credentials.get()

Response fields

dataobject
POST/api/v1/auth/webauthn/login/options
curl -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

mfaChallengeTokenrequiredstring
challengeTokenrequiredstring
credentialrequiredobject

AuthenticationResponseJSON from navigator.credentials.get()

200Session created
401Missing or invalid authentication

Response fields

userobject
sessionTokenstring
expiresAtstringdate-time
POST/api/v1/auth/webauthn/login/verify
curl -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
200Credential list

Response fields

dataWebAuthnCredential[]
countinteger
GET/api/v1/auth/webauthn/credentials
curl -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
idrequiredstringpath

Credential ID

deviceNamerequiredstring
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
idrequiredstringpath

Credential ID

passwordrequiredstring
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!"
  }'