POST /auth /registration /enduser

Edit online

By using POST /auth /registration /enduser API, you can complete the end user registration process and create the user’s initial credentials along with delegated wallets for the new end user. The type of credentials being registered is determined by the credentialKind field in the nested objects (firstFactorCredential , secondFactorCredential and RecoveryCredential).

Authentication

Registration Code

Required Permissions

No permissions required.

Authorizations

Bearer Token: To authenticate API requests.

Parameters

firstFactorCredential: Register a Fido2 Credential, also known as Passkeys or WebauthN credential.

wallets: Minimum length: 1

secondFactorCredential: Register a Fido2 Credential, also known as Passkeys or WebauthN credential.

recoveryCredential: Register a recovery key.

Request body

{
curl --request POST \
  --url https://api.digitalassets.ibm.com/auth/registration/enduser \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "firstFactorCredential": {
    "credentialKind": "Fido2",
    "credentialInfo": {
      "credId": "<string>",
      "clientData": "<string>",
      "attestationData": "<string>"
    },
    "credentialName": "<string>"
  },
  "secondFactorCredential": {
    "credentialKind": "Fido2",
    "credentialInfo": {
      "credId": "<string>",
      "clientData": "<string>",
      "attestationData": "<string>"
    },
    "credentialName": "<string>"
  },
  "recoveryCredential": {
    "credentialKind": "RecoveryKey",
    "credentialInfo": {
      "credId": "<string>",
      "clientData": "<string>",
      "attestationData": "<string>"
    },
    "encryptedPrivateKey": "<string>",
    "credentialName": "<string>"
  },
  "wallets": [
    {
      "network": "Algorand",
      "name": "<string>"
    }
  ]
}'

Response

200: Success

{
  "credential": {
    "uuid": "<string>",
    "kind": "Fido2",
    "name": "<string>"
  },
  "user": {
    "id": "<string>",
    "username": "<string>",
    "orgId": "<string>"
  },
  "authentication": {
    "token": "<string>"
  },
  "wallets": [
    {
      "id": "wa-1f04s-lqc9q-xxxxxxxxxxxxxxxx",
      "network": "Ethereum",
      "address": "0x00e3495cf6af59008f22ffaf32d4c92ac33dac47",
      "name": "trading hot wallet",
      "signingKey": {
        "id": "key-6ece3-9l565-xxxxxxxxxxxxxxxx",
        "scheme": "ECDSA",
        "curve": "secp256k1",
        "publicKey": "e2375c8c9e87bfcd0be8f29d76c818cabacd51584f72cb2222d49a13b036d84d3d"
      },
      "status": "Active",
      "dateCreated": "2023-04-14T20:41:28.715Z",
      "custodial": true,
      "tags": []
    }
  ]
}