Refreshing a SensePrint face

This endpoint re-issues an existing SensePrint as a freshly-keyed V4 SensePrint, verified against the same person's face. The previous SensePrint can be any version (V1, V2, V3, or V4). All metadata, cleartext_data, extra_binary_data, and tolerance settings are preserved in the new SensePrint.

Use this endpoint to:

• Migrate older SensePrints to V4 without re-enrolling the user
• Re-key an existing SensePrint when the underlying face template needs to be refreshed

Liveness is not checked during refresh. The liveness requirement on the new SensePrint is set independently via require_live_face.

Endpoint POST /refresh-senseprint-face Request Parameters:

Example Request

{
  "face_base_64": "face_image_bytes_as_base64",
  "password": "(optional)",
  "prev_senseprint_base_64": "prev_senseprint_bytes_as_base64",
  "require_live_face": true,
  "verifiers_auth_key": "(optional) when specified, must match the key used during the original SensePrint creation"
}

Response Structure

A successful response returns the refreshed V4 SensePrint bytes encoded as a Base64 string, ready to be stored in place of the original.

Example Response

{ "senseprint_base_64": "iVBORw0KGgoAAAANSUhEUgAAAVAAAAFKCAYAAABLpQckAAAMPmlDQ..." }