# Merge two identities

Merges a "toRetire" source identity into a "toSurvive" source identity. After a merge, the retired source is marked as merged and the surviving identity contains combined data. The response returns the surviving linkId.

Endpoint: POST /mergeIdentities
Version: 2026.1.2
Security: bearerAuth

## Request fields (application/json):

  - `auditId` (string)
    Unique audit identifier for correlating requests and responses.

  - `auditLogMap` (object)
    Map of string keys to string values.

  - `trackingId` (string)
    Optional client-defined correlation ID.

  - `content` (object)
    Merge (retire) data from one source into another.

  - `content.toSurviveSource` (object, required)
    Tracks an identity back to its source system.

  - `content.toSurviveSource.date` (string)

  - `content.toSurviveSource.name` (string)
    Unique source system name across Verato.

  - `content.toSurviveSource.id` (string)
    Native ID of the identity within the source.

  - `content.toRetireSource` (object, required)
    Tracks an identity back to its source system.

## Response 200 fields (application/json):

  - `auditId` (string)
    Unique audit identifier for correlating requests and responses.

  - `success` (boolean)
    Indicates whether the business operation succeeded.

  - `unparsedJson` (string)
    Raw response payload, for debugging or migration.

  - `warnings` (array)
    Non-fatal warnings generated by the operation.

  - `retryableError` (boolean)
    Indicates whether an error is transient and the request may be retried.

  - `message` (string)
    Human-readable status message.

  - `errors` (array)
    Error messages if success is false.

  - `trackingId` (string)
    Echo of the request trackingId, if provided.

  - `content` (object)
    Merge identities response content.

  - `content.linkId` (string)

  - `content.toSurviveSource` (object)
    Tracks an identity back to its source system.

  - `content.toSurviveSource.date` (string)

  - `content.toSurviveSource.name` (string)
    Unique source system name across Verato.

  - `content.toSurviveSource.id` (string)
    Native ID of the identity within the source.