How do I unmerge an entity into each of its contributing sources?

Shantanu

Updated January 07, 2021 14:00

Question

How do I unmerge contributors of an entity, in a single API call?

Answer

Unmerge all Contributors from an Entity

Unmerge all contributors from a composite entity created as a result of a merge.

If an entity is a composite (result of merge), every component (contributor) can be unmerged to be a standalone entity again. For example, there is a composite entity called origin and an unmerged entity called spawn. When you execute this API, the response is a list of spawns that represent the corresponding contributors unmerged from the composite entity origin.

The following LCA actions are not supported as the part when you post the request:

beforeUnmerge
beforeNotAMatchSet
afterNotAMatchSet
afterUnmerge

Request

POST {TenantURL}/<origin id>/_unmergeAllContributors
Authorization: Bearer {{token}}

Response

Returns the list of entity URIs which are spawns and the changed origin.

Unmerge Entity by Contributor URI

If an entity is composite (the result of merge), every component (contributor) can be unmerged to be a standalone entity again. Let us call the composite entity "Origin" and the unmerging one "Spawn".

Request

POST {TenantURL}/<origin id>/_unmerge?contributorURI=<spawn URI>

Response

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

References

https://docs.reltio.com/mergeapis/unmergeallcontributors.html

https://docs.reltio.com/mergeapis/unmergeentitybycontriburi.html