Skip to content
EyesOnItDocumentation6.1

Manage people and identities

Use an authorized identity-management caller and an enabled face-recognition feature. Prepare a permitted demonstration photo with exactly one detectable face.

  1. Create a group with an externalId and displayName if the identity needs group membership.
  2. Create an identity using its own stable external ID, display name, and optional groupIds. Store the returned identity ID.
  3. Enroll an ordinary JPEG or PNG with Enroll face image. The maximum upload is 4 MiB. Reuse the same idempotency key when retrying the same photo.
  4. Read Get face identity to confirm its samples. Use the sample operations to select a primary sample or remove a demonstration sample when appropriate.
  5. Reference the permitted identity or group in your camera’s face selector, then review recognition events within your camera access.

Set EOI_IDENTITY_ID to the created identity and choose a unique EOI_ENROLLMENT_KEY for this logical photo enrollment.

Terminal window
curl --fail-with-body --silent --show-error \
  --header "Authorization: Bearer ${EOI_SERVICE_TOKEN}" \
  --header "Content-Type: application/octet-stream" \
  --header "Idempotency-Key: ${EOI_ENROLLMENT_KEY}" \
  --data-binary @person-demo.jpg \
  "${EOI_API_BASE_URL}/face-identities/${EOI_IDENTITY_ID}/image-enrollments"

Organization grants control shared-identity access. Check ownership and grants before using identities across customer workspaces. Identity transfer uses a protected package and a separate inspect/preview/apply sequence in the identity transfer reference.

Image preview