talkvalue path person merge-undo

Reverse a prior person merge. talkvalue path person merge-undo restores the retired source record, splits the merged emails, phones, channels, events, and activity history back to their original owners, and returns the target to its pre-merge state. Use this when a merge collapsed the wrong pair and you catch it inside the retention window.

Synopsis

talkvalue path person merge-undo <mergeOperationId> --confirm

Arguments

Argument	Type	Description
`<mergeOperationId>`	integer	The merge operation to reverse. Find it in the target’s `person get` response under `mergeOperations[].id`, or in the dashboard’s activity log.

Options

Flag	Type	Description
`--confirm`	flag	Required. The CLI exits with a usage error if you omit this flag.

Examples

1. Undo a recent merge

talkvalue path person merge-undo 503 --confirm

Reverses merge 503. The output is { "undone": true, "mergeOperationId": 503 }. Re-read the target with person get to confirm the source is no longer in mergeOperations.

2. Find the operation ID from the target

talkvalue path person get 142 --json \
  | jq -r '.data.mergeOperations[0].id' \
  | xargs -I {} talkvalue path person merge-undo {} --confirm

Pulls the most recent merge on person 142 and reverses it in one pipeline. Handy when you know which target person was affected but not the specific operation ID.

3. Guard against a stale operation

op_id=503
if talkvalue path person merge-undo "$op_id" --confirm 2>/dev/null; then
  echo "Reversed merge $op_id"
else
  echo "Cannot undo $op_id (past retention window or already undone)" >&2
fi

The CLI exits non-zero on 404 (operation not found) or 409 (already undone, or past the retention window). See Exit codes for the full mapping.

Response

{
  "data": {
    "undone": true,
    "mergeOperationId": 503
  }
}

TalkValue replays the prior split. After the call, the source person ID resolves again via person get, and the target’s mergeOperations list no longer contains the reversed entry.

​Synopsis

​Arguments

​Options

​Examples

​1. Undo a recent merge

​2. Find the operation ID from the target

​3. Guard against a stale operation

​Response

​See also