Unmasking Errors

Common error messages from the Unmask API, what causes them, and how to fix them.

The Unmask API returns structured error messages for invalid or unauthorized requests.

Endpoint: PUT https://protecto-trial.protecto.ai/api/vault/unmask

Common errors

Scenario	Error message
Empty payload	`Payload is empty`
Missing `unmask` key	`unmask data missing`
Missing `token_value` field	`Missing token value field`
Empty `token_value`	`Missing token value`
Unmask failure	`Unmasking of given token values failed.`

Request:

{
  "unmask": [
    { "token_value": " " }
  ]
}

Response:

{
  "data": null,
  "success": false,
  "error": {
    "message": "Missing token value field"
  }
}

The token does not exist in the namespace. This can happen if:

The auth token used does not have unmask permission. Check with your admin to obtain a token with the correct permissions.

If the policy used during masking was an anonymization policy, the token is permanently irreversible. No permissions can override this.

Was this page helpful?

Last updated Mar 16, 2026