Preview

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

CustomerUnificationMergeClusterInput

Input to apply a MERGE outcome across every pair in an N-record cluster.

This page contains

    Fields

    advisorId ID!

    Advisor (tenant) scope; must match every pair in the cluster.

    primaryPartyId ID!

    Anchor party id retained as the cluster primary.

    memberPartyIds [ID!]!

    Other cluster members merged into the primary; must contain at least one entry.

    fieldSelections String

    JSON object mapping merge field names to per-field resolutions; shape mirrors CustomerUnificationSubmitDecisionInput.fieldSelections.

    notes String

    Optional shared note stored on each successfully recorded decision.

    rejectedPartyIds [ID!]

    Suggested cluster members the reviewer removed before merging. Pairs between these and the merged parties are recorded as REJECT so the review queue stops proposing them. Must not overlap primaryPartyId or memberPartyIds. Only pairs the review queue already proposed are recorded; a pair with no queue entry is skipped, and a pair whose latest decision is a MERGE is left untouched.

    Mutations for CustomerUnificationMergeClusterInput

    customerUnificationMergeCluster PREVIEW

    Record a MERGE decision for every (primary, member) pair in an N-record cluster using a single set of field selections supplied by the caller. Per-pair failures (missing pair, prior terminal decision) are isolated and reflected in succeeded / failed counters; the invariant succeeded + failed = memberPartyIds.length holds when the request is accepted. Suggested members passed as rejectedPartyIds are recorded as REJECT in a second batch once the merge batch succeeds, reported through rejectedSucceeded / rejectedFailed.