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! @deprecated( reason: "Not surfaced in the UI. Every returned cluster already clears the high-confidence floor." )

    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!]! @deprecated( reason: "No longer surfaced on the merge page. Always resolves to an empty list; will be removed once no client selects it." )PREVIEW

    Address rows linked to the left party.

    rightLocations: [CustomerUnificationPartyLocation!]! @deprecated( reason: "No longer surfaced on the merge page. Always resolves to an empty list; will be removed once no client selects it." )PREVIEW

    Address rows linked to the right party.

    existingDecision: CustomerUnificationDecision PREVIEW

    Prior clerical decision for this pair, if any.

    mergeInProgress: Boolean!

    True when a merge covering one of this cluster's parties has been submitted but not yet applied, so the suggestion is already resolved and must not be offered for review. Clears once the unification job runs.

    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 clusters awaiting clerical review for an advisor. Only high-confidence clusters are returned; lower-confidence candidates are excluded server-side and cannot be opted back in. Sorting and filters apply to the result; unrecognized sort fields fall back to service defaults.