Preview

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

CustomerUnificationCluster

Cluster of duplicate party records reachable from an entry-point pair. The size field is always 1 + the number of members; the primary record is the cluster anchor surfaced first.

This page contains

    Fields

    size: Int!

    Cluster size, including the primary record (1 + members.length).

    primary: CustomerUnificationPartyDetail! PREVIEW

    Anchor record returned first; clients may further re-rank by data completeness.

    members: [CustomerUnificationPartyDetail!]! PREVIEW

    All non-primary cluster members.

    existingDecisions: [CustomerUnificationDecision!]! PREVIEW

    Pair-level decisions present anywhere in the cluster.

    impactCounts: [CustomerUnificationPartyImpact!]! PREVIEW

    Per-member merge-impact counts (orders, quotes, locations) for records moving to the primary.

    mergeInProgress: Boolean!

    True when a merge has been submitted for this cluster but not yet applied, so the records are still listed separately. Clears once the unification job collapses the members onto one customer.

    Parent objects of CustomerUnificationCluster

    CustomerUnificationClusterConnection PREVIEW

    Async wrapper for the N-record cluster lookup; status mirrors review queue / pair detail patterns.

    Queries for CustomerUnificationCluster

    customerUnificationClusterByAdvisorId PREVIEW

    N-record cluster reachable from an entry point via transitive matches in the review queue or via recorded merge decisions. Returns the cluster anchor (primary), every other duplicate member, and any pair-level decisions already present in the cluster so the UI can render read-only state when applicable. When the warehouse read is in flight, status is PROCESSING and cluster is null; poll until READY. Entering by partyId returns a null cluster with status READY when the party has no merge decisions, so callers can fall back to a single-record view.