# Unlink two identities

Splits two previously linked identities into separate identity clusters. The operation uses the provided source information to determine which source identity should be extracted into a new linkId.

Endpoint: POST /unlinkIdentities
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)
    Unlink data from one identity to create another.

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

  - `content.unlinkFromSource.date` (string)

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

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

  - `content.source` (object)
    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)
    Unlink identities response content.

  - `content.unlinkedId` (string, required)

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

  - `content.unlinkedSource.date` (string)

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

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

  - `content.unlinkedFromId` (string, required)

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