Update Data Matching Definition

Update an existing Data Matching Definition with the given configuration.

SecurityapiKey

Request

path Parameters

required

string (DataMatchingDefinitionId)

ID of the Data Matching Definition.

Example: 6461e6113b1865304b3038b6

Request Body schema: application/json
required

object (GoldenRecordConfiguration)

Configuration for creating Golden Records in the context of Data Matching.

name

required

string <= 30 characters

A human-readable name for the Data Matching Definition instance.

Example: "Custom Matching Definition Name"

object (ReportConfiguration)

Configuration for generating reports related to the Data Matching Definition.

type

required

string (MatchingType)

Type of the matching configuration.

Enum:	Description
DEDUPLICATION	The matching configuration is used to identify duplicates in a storage.
LINKAGE	The matching configuration is used to identify links between records in different storages.

Example: "DEDUPLICATION"

object (Workspace)

Collaboration space to share/configure configurations.

xmlDukeConfiguration

required

string

Holds the Duke XML configuration for data matching.

Example: "<duke>...</duke>"

Responses

200

400

The sent request is malformed.

403

Permission denied.

put/datamatchingdefinitions/{id}

Request samples

Payload
curl
Python
Java
Node.js

application/json

{"name": "Custom Matching Definition Name",
"type": "DEDUPLICATION",
"xmlDukeConfiguration": "<duke>...</duke>",
"reportConfiguration": {"header": [{"attributeJsonPath": "attributeJsonPath",
"columnName": "External ID"
}
]
},
"goldenRecordConfiguration": {"decisionStrategy": {"root": {"rule": {"type": "HAS_VALUE",
"jsonPath": "attributeJsonPath",
"valueType": "TEXT",
"expectedValues": ["expectedValue"
]
},
"yesBranch": { },
"noBranch": { }
}
},
"creationStrategy": {"type": "CONSTANT",
"protectedAttributes": ["External ID"
],
"recordExclusionRules": [{"type": "HAS_VALUE",
"jsonPath": "attributeJsonPath",
"valueType": "TEXT",
"expectedValues": ["expectedValue"
]
}
],
"attributeEnhancementRules": [{"attributes": ["External ID"
],
"constraintChain": {"constraints": [{"type": null,
"jsonPath": null,
"valueType": null,
"expectedValues": [ ]
}
],
"allRecordsShouldMatch": "true",
"constraintChainType": "AND"
},
"creationType": "CONSTANT",
"creationConstant": "constantValue",
"executionType": "SET",
"fallbackExecutionType": "SET"
}
]
}
},
"workspace": {"id": "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
}
}

Response samples

application/json

{"id": "6461e6113b1865304b3038b6",
"name": "Custom Matching Definition Name",
"creatorUsername": "johndoe",
"creatorOrganization": "cdq_monitor",
"createdAt": "2025-03-14T11:41:22Z",
"lastModifiedAt": "2025-03-14T11:41:22Z",
"type": "DEDUPLICATION",
"xmlDukeConfiguration": "<duke>...</duke>",
"reportConfiguration": {"header": [{"attributeJsonPath": "attributeJsonPath",
"columnName": "External ID"
}
]
},
"goldenRecordConfiguration": {"decisionStrategy": {"root": {"rule": {"type": "HAS_VALUE",
"jsonPath": "attributeJsonPath",
"valueType": "TEXT",
"expectedValues": ["expectedValue"
]
},
"yesBranch": { },
"noBranch": { }
}
},
"creationStrategy": {"type": "CONSTANT",
"protectedAttributes": ["External ID"
],
"recordExclusionRules": [{"type": "HAS_VALUE",
"jsonPath": "attributeJsonPath",
"valueType": "TEXT",
"expectedValues": ["expectedValue"
]
}
],
"attributeEnhancementRules": [{"attributes": ["External ID"
],
"constraintChain": {"constraints": [{"type": null,
"jsonPath": null,
"valueType": null,
"expectedValues": [ ]
}
],
"allRecordsShouldMatch": "true",
"constraintChainType": "AND"
},
"creationType": "CONSTANT",
"creationConstant": "constantValue",
"executionType": "SET",
"fallbackExecutionType": "SET"
}
]
}
},
"workspace": {"id": "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"
}
}