> ## Documentation Index
> Fetch the complete documentation index at: https://api-tools.memories.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Person

> Build a person from reference faces

<Info>
  **Product**: Video Datalake
  **Host**: `https://api.memories.ai/datalake/v1`
  **Auth**: `Authorization: sk-mai-...`
</Info>

Build a person in the face-reference library (202, async). Requires the collection's `face_recognition_enabled: true` and a **compliance token** — `metadata.consent_reference` on the person or `consent_document` on the collection. If any image has no detectable face, the build fails (`no_face`).

<Note>
  **Pricing:** \$0.00005 / reference image · See [Pricing](/datalake/pricing) for the full model.
</Note>

<Warning>
  Persons hold biometric data. Always supply a real `consent_reference` — never fabricate one.
</Warning>

## Response Fields

<ResponseField name="person_id" type="string">New person ID (`per_` prefix).</ResponseField>
<ResponseField name="operation" type="string">Build Operation; poll to `ready`.</ResponseField>


## OpenAPI

````yaml POST /datalake/v1/persons
openapi: 3.1.0
info:
  title: Memories.ai DataLake API 2.0
  version: 2026-08
  description: OpenAPI mapping used by Mintlify Try it for the DataLake API 2.0 docs.
servers:
  - url: https://api.memories.ai
security:
  - ApiKeyAuth: []
paths:
  /datalake/v1/persons:
    post:
      tags:
        - Persons (Face Library)
      summary: Build a person from reference faces
      description: >-
        Build a person in the face-reference library (202, async). Requires the
        collection's `face_recognition_enabled: true` and a **compliance token**
        — `metadata.consent_reference` on the person or `consent_document` on
        the collection. If any image has no detectable face, the build fails
        (`no_face`).
      operationId: create_person
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                collection_id:
                  type: string
                name:
                  type: string
                  description: ≤255
                faces:
                  type: array
                  items:
                    type: string
                  description: >-
                    1–20 http(s) image direct links (multipart alt: `faces` file
                    parts, ≤15MB each).
                metadata:
                  type: object
                  description: >-
                    Must carry `consent_reference` unless the collection has a
                    `consent_document`.
              required:
                - collection_id
                - name
                - faces
              example:
                collection_id: col_xxx
                name: Alice
                faces:
                  - https://cdn/alice-1.jpg
                metadata:
                  consent_reference: c-001
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                person_id: per_xxx
                status: processing
                operation: op_xxx
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'Send `Authorization: sk-mai-...`'

````