Prepare passkey registration (Step 1)

POST

/api/v1/wallets/{entityId}/prepare-passkey-registration

Prepares a passkey registration challenge for adding a new authenticator to an entity.
Passkey serves as secondary authentication method.

Request

Authorization

Add parameter in header

x-api-token

Example:

x-api-token: ********************

Path Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Passkey registration challenge prepared successfully

Body

🟠400Bad Request

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v1/wallets//prepare-passkey-registration' \
--header 'Content-Type: application/json' \
--data-raw '{
    "passkey": {
        "authenticatorName": "string",
        "challenge": "string",
        "attestation": {
            "credentialId": "string",
            "clientDataJson": "string",
            "attestationObject": "string",
            "transports": [
                "string"
            ]
        }
    }
}'

Response Example

200 - Example 1

{
    "payloadId": "string",
    "payloadToSign": "string",
    "rpId": "string"
}

Modified at 2025-11-22 18:20:11

Submit account creation activity (Step 2)

Submit passkey registration (Step 2)