Preview

CustomerUnificationReviewQueueItem is in Preview status and is subject to change without notice. For more information about Preview status, see the GraphQL API policy.

CustomerUnificationReviewQueueItem

A pending merge cluster: transitively linked party pairs grouped into one connected component for clerical review. Listing rows use the representative pair id and primary party display fields; full members are loaded on the cluster detail query.

This page contains

    Fields

    pairId: ID!

    Stable identifier for the representative pair in this cluster (used for Review navigation).

    clusterId: ID!

    Deterministic identifier for the connected component.

    memberCount: Int!

    Number of distinct parties in the cluster.

    advisorId: ID!

    Advisor (tenant) that owns this queue entry.

    leftEntityType: String

    Entity type label for the left record, from the upstream source.

    leftSourceSystem: String

    Source system identifier for the left party.

    leftSourceId: String

    Business key of the left party in its source system.

    leftName: String

    Display name or primary label for the left party when returned as summary fields on this query.

    rightEntityType: String

    Entity type label for the right record.

    rightSourceSystem: String

    Source system identifier for the right party.

    rightSourceId: String

    Business key of the right party in its source system.

    rightName: String

    Display name or primary label for the right party when returned as summary fields on this query.

    matchProbability: Float!

    Estimated probability (0.0–1.0) that the two records are the same entity.

    matchWeight: Float!

    Aggregate match score weight; higher values indicate stronger combined match evidence.

    updatedAt: DateTime

    Last time the queue row or its party sources changed in the warehouse (RFC 3339).

    fieldComparisons: [CustomerUnificationFieldComparison!]! PREVIEW

    Per-field comparison signals contributing to the match score.

    leftEntity: CustomerUnificationPartyDetail PREVIEW

    Full attribute set for the left party when included in the response; null if omitted.

    rightEntity: CustomerUnificationPartyDetail PREVIEW

    Full attribute set for the right party when included in the response; null if omitted.

    leftLocations: [CustomerUnificationPartyLocation!]! PREVIEW

    Address rows linked to the left party.

    rightLocations: [CustomerUnificationPartyLocation!]! PREVIEW

    Address rows linked to the right party.

    existingDecision: CustomerUnificationDecision PREVIEW

    Prior clerical decision for this pair, if any.

    Parent objects of CustomerUnificationReviewQueueItem

    CustomerUnificationPairDetailConnection PREVIEW

    Wrapper for pair detail that surfaces async query status so clients can poll.

    CustomerUnificationReviewQueueConnection PREVIEW

    Cursor-paginated connection of pending merge clusters for an advisor.

    Queries for CustomerUnificationReviewQueueItem

    customerUnificationPairDetailByAdvisorId PREVIEW

    Full queue row for one pair including hydrated parties, locations, field comparisons, and existing decision. When the warehouse read is still in flight, status is PROCESSING and item is null; poll until status is READY.

    customerUnificationReviewQueueByAdvisorId PREVIEW

    Cursor-paged list of candidate duplicate pairs awaiting clerical review for an advisor. Sorting and filters apply to the result; unrecognized sort fields fall back to service defaults.