Affinity: V2 Person Merges Post

Initiate Person Merge.

Tool ID: affinity_v2_person_merges_post

Run this action

Use the TypeScript SDK for a single call. Put ctx.tools.execute(...) inside a Play when the call should be durable, scheduled, or run across a CSV.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'affinity_v2_person_merges_post',
  {
    "primaryPersonId": 123,
    "duplicatePersonId": 123
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute affinity_v2_person_merges_post --input '{
  "primaryPersonId": 123,
  "duplicatePersonId": 123
}' --json

Example response

The SDK exposes this shape at result.toolResponse.raw. Values below are representative.

{
  "data": {
    "taskUrl": "https://example.com/resource"
  }
}

Use deepline tools get affinity_v2_person_merges_post --json for the latest machine-readable contract.

Input reference

Request body for initiating a person merge

Name	Type	Required	Default	Details
`payload.primaryPersonId`	`integer`	Yes	—	The ID of the person profile that will be kept after the merge. All data from the duplicate person will be merged into this person. Format: `int64`. Minimum: 1. Maximum: 9007199254740991.
`payload.duplicatePersonId`	`integer`	Yes	—	The ID of the person profile that will be merged and then deleted. All data from this person will be transferred to the primary person. Format: `int64`. Minimum: 1. Maximum: 9007199254740991.
`payload.wait_for_completion`	`boolean`	No	`true`	Poll the Affinity merge task before returning. Set false to return the task handle immediately.
`payload.poll_interval_ms`	`integer`	No	`1000`	Milliseconds between merge task status polls. Minimum: 100. Maximum: 10000.
`payload.max_wait_ms`	`integer`	No	`30000`	Maximum synchronous wait before returning a running task handle. Minimum: 1000. Maximum: 30000.

Output reference

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	—
`result.data.taskUrl`	`string`	Yes	—	Format: `uri`.
`result.data.taskId`	`string`	No	—	Affinity merge task ID.
`result.data.status`	`"in-progress" \| "success" \| "failed"`	No	—	Current merge task status. Allowed: `in-progress`, `success`, `failed`.
`result.data.launcher`	`record`	No	—	Original Affinity merge launch response.
`result.data.task`	`record`	No	—	Terminal Affinity merge task response.
`result.data.latestTask`	`object \| null`	No	—	Latest task response observed before the sync wait ended.
`result.data.asyncGetAction`	`string`	No	—	Action to poll while the merge remains in progress.
`result.meta`	`object`	No	—	—

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

Getting Started

GTM is code

Features

Deepline SDK beta

Integrations

API Reference

Affinity: V2 Person Merges Post

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation