Recover

Reset ownership of underlying digital ID

POST /v1/tags/recover

Recovers the digital ID (also known as digital token or NFT) back to the Legitimate wallet to reset the ownership state of the digital ID. The uuid, cmac, and ctr must be from the latest verification. All previous verifications are invalid to prevent users with old links from recovering.

After recovery, the digital ID can be claimed again with the claim API.

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
uid	string (14 hex characters)	The unique ID of the tag
ctr	string (6 hex characters)	The nonce of the scan
cmac	string (20 hex characters)	The digital signature of the tag

Response

200

{
  hash: string  // hash of on-chain transaction, tx may not be confirmed yet
}

4XX

{
  error: "Unauthorized" |
    "Ownership reset has not been enabled for contract ${contract.address} by ${walletAddress}." |
    "Transaction failed with message: ${error.message}"
}