PotentialMatches

The review queue: pairs the platform is unsure about, with the evidence for and against.

📄️List candidate duplicate pairs

Returns the pairs the matching engine could not settle on its own, for a steward to decide. Pairs above the auto-link threshold have already been merged and do not appear here; these are the ones in the review band. Requires `potential-match.read`.

📄️Get a candidate pair

Returns one pair side by side with the evidence behind its score: which attributes agreed, which disagreed, and how much each contributed. This is what a steward reads before deciding. Requires `potential-match.read`.

📄️Confirm a pair as the same record

Accepts the pair as one real-world thing and merges them. The surviving record keeps the winning value for each attribute according to the profile's survivorship rules, and the merge is reversible. Requires `entity.merge` and `potential-match.resolve`.

📄️Reject a pair as different records

Records that these are genuinely different things. The decision is remembered, so the same pair is not raised again. Requires `potential-match.resolve`.

📄️Snooze a pair

Defers the decision without resolving it — for when the answer needs information you do not yet have. The pair returns to the queue later. Requires `potential-match.resolve`.