---
title: "Preview Tag Rule Import Endpoint"
method: POST
path: "/previewTagRuleImport"
---

# Preview Tag Rule Import Endpoint

`POST /previewTagRuleImport`

## Request

- Base URL: `https://api.pavoot.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pavoot.com/previewTagRuleImport`
- Auth: none declared

Match CSV guest names against the org's people before an import. Read-only.

Body: { projectId, names: [str] }
Returns { matches: { name: { status: exact|fuzzy|new, personId?, personName?, hasFace?,
          candidates: [{ personId, name, hasFace, score }] } } }
Lists org people's names, so it also needs the faces read gate (like /getOrgPersons).

## Response `200`

Successful Response

- unknown

## Changes

- **2026-09-26** `2c06d2d329ca`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pavoot/apis/pavoot-api/changes/previewTagRuleImport/post.md)

---

[API](https://skmtc.dev/pavoot/apis/pavoot-api.md) - [All operations](https://skmtc.dev/pavoot/apis/pavoot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pavoot/apis/pavoot-api/revisions/8c0cd91c2a05?raw)