POST /v2/auth/face/init-session

Relays the FaceTec Device SDK's initialization exchange through auth-svc. Call this endpoint once whenever the Device SDK is initialized, before starting its first scan, and pass the returned responseBlob back to the SDK. You do not need to call it before every scan.

This request does not use a user-specific FaceTec reference or create a face session.

Used in flow: Device SDK initialization, before its first enrollment or match scan

Authentication: JWT (Access Token)

Request

Authorization: Bearer <access_token>
Content-Type: application/json

{
  "requestBlob": "<blob from the Device SDK>",
  "userAgent": "<user agent string from the Device SDK>"
}

Field	Type	Required	Description
requestBlob	string	Yes	Session request blob produced by the FaceTec Device SDK
userAgent	string	Yes	User agent string produced by the FaceTec Device SDK

Response

200 OK

{
  "responseBlob": "<blob to pass back into the Device SDK>"
}

400 Bad Request

{
  "error": {
    "code": 100227,
    "message": "Missing FaceTec requestBlob"
  }
}

500 Internal Server Error

{
  "error": {
    "code": 100412,
    "message": "FaceTec upstream request failed"
  }
}