---
title: "Preview an ordered manual entity merge"
method: POST
path: "/api/v1/ackdb/entities/merge/preview"
tags: ["ackDB"]
---

# Preview an ordered manual entity merge

`POST /api/v1/ackdb/entities/merge/preview`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/ackdb/entities/merge/preview`
- Auth: HTTP bearer

Runs the real company-relationship reconciliation for the supplied winner and loser in a rollback-only transaction. No data moves and no event persists. Use the same ordered pair with POST /entities/merge to apply.

## Request body

- AckdbMergeRequest: Request to merge two duplicate entities. Winner keeps its entity_id.
  - `winnerId` string, required: Entity that survives the merge.
  - `loserId` string, required: Entity that gets soft-deleted after merge.

## Response `200`

Relationship impact preview

- object
  - `data` object, required
    - `winnerId` string, required
    - `loserId` string, required
    - `relationshipImpact` AckdbCompanyRelationshipMergeImpact, required
      - `relationshipsRepointed` integer, required
      - `relationshipDuplicatesConsolidated` integer, required
      - `selfRelationshipsRetracted` integer, required

## Other responses

- `404`: Entity not found
- `409`: Entity is not active

---

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