Unmerge Entity Tree by Contributor URI

Learn how to use the Tree Unmerge API to restore a contributor entity and its full merge history from a composite entity.

If an entity is a composite entity (a result of a merge), then each contributor can be unmerged and reverted to a standalone entity. For example, the name of the composite entity is Origin and the unmerging entity is Spawn. The difference between the below POST request and the unmerge entity request is in the result. If the Spawn entity was a result of multiple merges, then it is unmerged with all the content contributed in the previous merges. In the case of non-tree unmerge, only the initial state of the Spawn entity is unmerged. The subsequent merges to the Spawn entity are not unmerged.

Request

POST https://<environment>.reltio.com/reltio/api/<tenantId>/entities/<originEntityId>/_treeUnmerge?contributorURI=<spawn URI>

Replace the placeholder values with your actual environment, tenant ID, origin entity ID, and contributor URI.


Parameter		Required	Description
Headers	`Authorization`	Yes	Information about authentication access token in format "Bearer `<accessToken>`" (see details in Authentication API ).
Query	`spawnId`	Yes	URI of an entity that has been merged into `Origin` and is now going to be detached from it.
Contributor URI	`contributorUri`	Yes	URI of contributor that needs to be unmerged.

Spawn must be the part of Origin at the moment. If it's not, an error will be returned. Parts of actual entities can be seen in the crosswalk tree.

Example Request

POST https://test.reltio.com/reltio/api/8Kv4arIxdrx73EZ/entities/7KXiejf/_treeUnmerge?contributorURI=entities/7U7Mhg8

Example Response

Returns a pair of entities, "a" and "b", where "a" stands for the modified Origin and "b" for Spawn.

{
  "a": {
    "uri": "entities/7KXiejf",
    "type": "configuration/entityTypes/HCP",
    "createdBy": "auto20220620_AdmintBRxx",
    "createdTime": 1655711319157,
    "updatedBy": "auto20220620_AdmintBRxx",
    "updatedTime": 1655711325585,
    "attributes": {
      "FirstName": [
        {
          "type": "configuration/entityTypes/HCP/attributes/FirstName",
          "ov": true,
          "value": "UnmergeQA2TXN4 E1 Rnd_8661 UniqVal86758467548967549635789435",
          "uri": "entities/7KXiejf/attributes/FirstName/iJi51QJL"
        }
      ]
    },
    "isFavorite": false,
    "crosswalks": [
      {
        "uri": "entities/7KXiejf/crosswalks/iJi52Jih",
        "type": "configuration/sources/AMA",
        "value": "UnmergeQA2TXN4.7e.e1.AMA1",
        "reltioLoadDate": "2022-06-20T07:48:39.157Z",
        "createDate": "2022-06-20T07:48:39.157Z",
        "updateDate": "2022-06-20T07:48:39.157Z",
        "attributes": [
          "entities/7KXiejf/attributes/FirstName/iJi51QJL"
        ],
        "singleAttributeUpdateDates": {}
      }
    ],
    "analyticsAttributes": {}
  },
  "b": {
    "uri": "entities/7U7Mhg8",
    "type": "configuration/entityTypes/HCP",
    "createdBy": "auto20220620_AdmintBRxx",
    "updatedBy": "auto20220620_AdmintBRxx",
    "updatedTime": 1655711325585,
    "attributes": {
      "FirstName": [
        {
          "type": "configuration/entityTypes/HCP/attributes/FirstName",
          "ov": true,
          "value": "UnmergeQA2TXN4 E7.3 Rnd_8661",
          "uri": "entities/7U7Mhg8/attributes/FirstName/hStixMqY"
        },
        {
          "type": "configuration/entityTypes/HCP/attributes/FirstName",
          "ov": false,
          "value": "UnmergeQA2TXN4 E7 Rnd_8661",
          "uri": "entities/7U7Mhg8/attributes/FirstName/hStiyOmQ"
        },
        {
          "type": "configuration/entityTypes/HCP/attributes/FirstName",
          "ov": false,
          "value": "UnmergeQA2TXN4 E7.2 Rnd_8661",
          "uri": "entities/7U7Mhg8/attributes/FirstName/hStiwCOA"
        }
      ]
    },
    "isFavorite": false,
    "crosswalks": [
      {
        "uri": "entities/7U7Mhg8/crosswalks/hStisPxy",
        "type": "configuration/sources/SDS",
        "value": "UnmergeQA2TXN4.7e.e7.SDS1",
        "reltioLoadDate": "2022-06-20T07:48:41.775Z",
        "createDate": "2022-06-20T07:48:41.775Z",
        "updateDate": "2022-06-20T07:48:41.775Z",
        "attributes": [
          "entities/7U7Mhg8/attributes/FirstName/hStiwCOA"
        ],
        "singleAttributeUpdateDates": {}
      },
      {
        "uri": "entities/7U7Mhg8/crosswalks/hStiuCmg",
        "type": "configuration/sources/AMA",
        "value": "UnmergeQA2TXN4.7e.e7.AMA1",
        "reltioLoadDate": "2022-06-20T07:48:43.284Z",
        "createDate": "2022-06-20T07:48:43.284Z",
        "updateDate": "2022-06-20T07:48:43.284Z",
        "attributes": [
          "entities/7U7Mhg8/attributes/FirstName/hStixMqY"
        ],
        "singleAttributeUpdateDates": {}
      },
      {
        "uri": "entities/7U7Mhg8/crosswalks/ilCEfDu4",
        "type": "configuration/sources/AHA",
        "value": "UnmergeQA2TXN4.7e.e7.AHA1",
        "reltioLoadDate": "2022-06-20T07:48:40.521Z",
        "createDate": "2022-06-20T07:48:40.521Z",
        "updateDate": "2022-06-20T07:48:40.521Z",
        "attributes": [
          "entities/7U7Mhg8/attributes/FirstName/hStiyOmQ"
        ],
        "singleAttributeUpdateDates": {}
      }
    ],
    "analyticsAttributes": {}
  }
}

Unify and manage your data

Unmerge Entity Tree by Contributor URI

Footer