Preview

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

customerUnificationMergeCluster

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.

This page contains

    Authorization Rules

    This request requires authorization with at least one of the following scopes:

    Scopes

    ROLE_RESELLER

    ROLE_CHANNEL_ADMIN

    Arguments

    input CustomerUnificationMergeClusterInput! PREVIEW

    CustomerUnificationMergeClusterInput 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.

    Return Fields

    decision CustomerUnificationDecision PREVIEW

    First persisted decision when at least one pair succeeded; null when all per-pair attempts failed.

    succeeded Int!

    Number of pairs whose decision was recorded (or was already idempotently in the requested state).

    failed Int!

    Number of pairs whose decision could not be recorded (missing pair or prior terminal conflict).

    userErrors [CustomerUnificationSubmitDecisionError!] PREVIEW

    Whole-call validation errors (e.g. invalid input shape); empty or null when the request was accepted.

    Interactive example

    This is an example mutation query. Use the embedded interactive tool below to edit the query.

    Hint: use Ctrl + Space for autocompleting fields.