---
title: "Add Person Face Endpoint"
method: POST
path: "/addPersonFace"
---

# Add Person Face Endpoint

`POST /addPersonFace`

Endpoint for adding a person to the face recognition system.
If scanExistingFaces is "true", starts a background scan for matches in existing stored faces.
If bulk is "true", skips folder update, persons emit, and duplicate scan; call completeBulkFaceUpload when done.

Args:
    name: The person's name
    projectId: The project ID this person belongs to
    category: Category/type of person (default: "person")
    position: The person's position/role (optional)
    link: Link associated with the person (optional)
    faceImageId: Face image ID to associate with the person (used to fetch image from S3)
    scanExistingFaces: If "true", scan existing images for this person after registration
    bulk: If "true", do not run background tasks (folders, persons emit, duplicate scan); caller must call completeBulkFaceUpload at the end

Returns:
    JSON response with success status and person details

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/pavoot/apis/fastapi.md) · [All operations](https://skmtc.dev/pavoot/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pavoot/fastapi/revisions/3966713f5d52/schema)