importers

Import Face Lists

Bulk import face List Items by uploading image files.

Each file being a new List Item. We recommend uploading max 50 images (with average image size of 500KB) at a time.

IMPORTANT: You must ensure proper consent for processing of biometrics is in place prior to using face Lists.

post/importer/list-item/faces

Request

  • Base URL: https://api.withpersona.com/api/v1
  • URL: https://api.withpersona.com/api/v1/importer/list-item/faces
  • Auth: HTTP bearer

Query parameters

includestring

A comma-separated list of relationship paths. This can be used to customize which related resources will be fully serialized in the included key in the response. See Serialization for more details.

fieldsobject

Comma-separated list(s) of attributes to include in the response. This can be used to customize which attributes will be serialized in the response. See Serialization for more details.

Headers

Key-Inflection'camel' | 'kebab' | 'snake'

Determines casing for the API response.

Idempotency-Keystring

Ensures the request is idempotent.

Persona-Version'2026-09-29' | '2025-12-08' | '2025-10-27' | '2023-01-05' | '2022-09-01' | '2021-08-18' | '2021-07-05' | '2021-02-21' | '2020-05-18'

Server API version. More info on versioning can be found here.

Response

This endpoint returns an Importer object.

Changes

No recorded changes to this operation across all 1 revision of this API.