---
title: "Assign Face Endpoint"
method: PUT
path: "/assignFace"
---

# Assign Face Endpoint

`PUT /assignFace`

Assign or rename a face/person based on 4 explicit scenarios:

- single_new:       only this face → create new person
- single_existing:  only this face → assign to existing person
- all_new:          rename this entire person to a new name
- all_existing:     merge this entire person into an existing person

## Request body

- AssignFaceRequest
  - `faceId` string, required
  - `newName` string, required
  - `renameMode` 'single_new' | 'single_existing' | 'all_new' | 'all_existing', required
  - `targetPersonId` string, nullable

## 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/16997cca6697/schema)