Skip to main content
POST
/
auth
/
recover
/
user
Recover User
curl --request POST \
  --url https://api.dfns.io/auth/recover/user \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "recovery": {
    "kind": "RecoveryKey",
    "credentialAssertion": {
      "credId": "<string>",
      "clientData": "<string>",
      "signature": "<string>",
      "algorithm": "<string>"
    }
  },
  "newCredentials": {
    "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>"
    }
  }
}'
{
  "credential": {
    "uuid": "<string>",
    "kind": "Fido2",
    "name": "<string>"
  },
  "user": {
    "id": "<string>",
    "username": "<string>",
    "orgId": "<string>"
  }
}

Authentication

❌ Organization User (CustomerEmployee)
❌ Delegated User (EndUser)
❌ Service Account
✅ Recovery Code

Required Permissions

No permission required.

Authorizations

Authorization
string
header
required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

Body

application/json
recovery
object
required
newCredentials
object
required

Response

200 - application/json

Success

credential
object
required
user
object
required
I