Business Entity Services Guide

10.5 HotFix 2

Back Next

Request Body

Before you use the Update Pending Merge API, use the Read Matched Records REST API to determine the matched records that you can merge with the target root record. Send the list of records in the request body for the Update Pending Merge API.

You can override field values in the root record. For example, if none of the matched root records contain the correct spelling of the first name, you can specify the correct first name in the request body. Also, you can remove matched records or specify other matching records.

Use the following properties in the request body:

Properties / Elements	Type	Description
keys	array	Required. An ordered list of the matched root records that you want to merge. You can identify the records either by row ID or by a combination of the source system and the source key.
overrides	object	Overrides the field values in a root record and the matches for child records.
MERGE	object	Overrides the field values in child records that you want to merge. Add the type of child record within the overrides object and then add the MERGE object.

The following JSON code sample identifies two root records to merge with the target root record:

{
  keys: [
    {rowid: "2478246"},
    {rowid: "2478230"}
  ]
}

The following sample request body shows how to override a field in the Party root record and how to override the matched records for Telephone child records:

{
  keys: [
    {
      rowid: "2478246"
    }
  ]
  overrides: {
    Party: {
      rowidObject: "2478230",
      firstName: "Charlie",   //Override the value for the first name
      Telephone: {   // Specifies the Telephone child records to merge
        item:[
          {
            rowidObject: "2511",
            MERGE: {
              item: [   // To remove the original merge candidates, specify null
                null,
                null
              ],
              $original: {
                item: [
                  {key:{rowid: "2822"}},
                  {key:{rowid: "2733"}}
                ]
              }
            }
          },
          {
            rowidObject: "2644",
            MERGE: {
              item: [   // To add or change merge candidates, specify matched records
                {key:{rowid: "2822"}}
              ],
            $original: {
              item: [
                null
              ]
            }
          }
        ]
      }
    }
  }
}

Rename Saved Search

Table of Contents

Business Entity Services Guide

Business Entity Services Guide

Request Body

Request Body