Use the merge API to merge multiple source records or master records into a single master record. You can merge up to 10 records in a single API request. The API uses the entity-group resource.
To merge records, submit a POST request with the following URI:
Where, <businessEntity> is the internal ID of the business entity to which the records belong.
The response is in the JSON format.
Request body
To merge records, you can either use a combination of the sourcePKey and sourceSystem parameters or the businessId parameter in the request body.
To merge records, you can use the following parameters in the request body:
Parameter
Type
Description
sourcePKey
String
The primary key of the source record. Used along with the sourceSystem parameter.
sourceSystem
String
Internal ID of the source system to which the record belongs. Used along with the sourcePKey parameter.
businessId
String
Unique identifier of the record to merge.
Request response
The request response returns the business ID of the master record into which all the records were merged.
The following table lists the response parameters:
Parameter
Type
Description
approvalRequired
Boolean
Specifies whether approval workflow is configured. If the response is true, approval workflow is configured. If the response is false, approval workflow is not configured.
businessId
String
Unique identifier of the business entity record.
Sample Request
You might use the following request to merge the source records of the Person business entity into a single master record:
POST https://use4-mdm.dm-us.informaticacloud.com/business-entity/public/api/v1/entity-group/c360.person Content-Type: application/json Accept: application/json IDS-SESSION-ID: XXXXXXXXXXXXXXXXXXXXXX