Partial Update in RDM Lookups

Learn how partial enablement lets you update reference data lookups incrementally, without replacing the full definition.

Partial update for Reltio Reference Data Management (RDM) lookups allows you to update lookup components incrementally, without needing to replace the entire lookup object. Using the new partial update API, you can insert, update, or delete only the specific parts of a lookup such as source mappings, localizations, parents, and attributes. You can also enable or disable the lookup itself as part of the same request.

Partial updates support three core operation types: INSERT, UPDATE, and DELETE. These operations are applicable to the following lookup components:

Source Mappings: Map external system values to lookup codes
Localizations: Provide translations for different languages
Parents: Define hierarchical relationships between lookups
Attribute: Store custom metadata

HTTP method and endpoint

Use the following endpoint for partial updates:

POST: {{rdm_uri}}/lookups/{{rdm_tenant}}/_update

Example of rdm_uri: https://rdm.reltio.com

Set or preserve the lookup status

When performing partial updates, you can include the top-level enabled field to change the lookup's status. If the field is omitted or set to null, the existing value is preserved. If explicitly set to true or false, the status is updated. This behavior applies only to the lookup-level enabled field. For source mappings, enabled must always be specified as either true or false.

Example: Update values while preserving lookup status

You can update components such as source mappings without changing the RDM lookup's enabled state.

{
  "tenantId": "{{rdm_tenant}}",
  "type": "rdm/lookupTypes/Country",
  "code": "US",
  "sourceMappings": [...]
}

Or explicitly preserve the current state using enabled: null:

{
  "tenantId": "{{rdm_tenant}}",
  "type": "rdm/lookupTypes/Country",
  "code": "US",
  "enabled": null,
  "sourceMappings": [...]
}

In both examples, the existing enabled value remains unchanged.

Example: Enable or disable a RDM lookup

You can update the RDM lookup's status without modifying any of its content:

{
  "tenantId": "{{rdm_tenant}}",
  "type": "rdm/lookupTypes/Country",
  "code": "US",
  "enabled": true
}

This enables the RDM lookup and leaves other elements, such as source mappings and localizations, unchanged.

Modify multiple lookups codes in a single request

You can modify multiple lookups codes in a single request by including each one as an object- in a JSON array. This allows you to apply different partial update operations — such as inserting source mappings, updating localizations, or deleting attributes — across several lookup entries in a single batch.

A single request can include up to 100 lookup records. Each object in the array must include its own tenantId, type, and code.

[
  {
    "tenantId": "{{rdm_tenant}}",
    "type": "rdm/lookupTypes/Country",
    "code": "US",
    "sourceMappings": [
      {
        "source": "Reltio",
        "values": [
          {
            "operation": "INSERT",
            "code": "USA",
            "value": "United States of America",
            "enabled": true,
            "canonicalValue": false,
            "downStreamDefaultValue": false
          }
        ]
      }
    ]
  },
  {
    "tenantId": "{{rdm_tenant}}",
    "type": "rdm/lookupTypes/Country",
    "code": "CA",
    "localizations": [
      {
        "operation": "INSERT",
        "languageCode": "fr-FR",
        "value": "Canada",
        "description": "Canada in French Canadian"
      }
    ]
  }
]

Example of all partial operations in one request

This example shows how to combine all partial operation types in a single request, including updates to source mappings, localizations, parent relationships, and custom attributes.

[
  {
    "tenantId": "{{rdm_tenant}}",
    "type": "rdm/lookupTypes/Country",
    "code": "US",
    "enabled": true,
    "sourceMappings": [
      {
        "source": "Reltio",
        "values": [
          {
            "operation": "INSERT",
            "code": "USA",
            "value": "USA",
            "enabled": true,
            "canonicalValue": false,
            "downStreamDefaultValue": false
          },
          {
            "operation": "UPDATE",
            "code": "US",
            "value": "United States",
            "enabled": true,
            "canonicalValue": true,
            "downStreamDefaultValue": true
          }
        ]
      }
    ],
    "localizations": [
      {
        "operation": "INSERT",
        "languageCode": "it-IT",
        "value": "Stati Uniti",
        "description": "United States in Italian"
      },
      {
        "operation": "UPDATE",
        "languageCode": "es-ES",
        "value": "Estados Unidos de América",
        "description": "Updated Spanish translation"
      }
    ],
    "parents": [
      {
        "operation": "INSERT",
        "parent": "rdm/lookupTypes/Region/NorthAmerica"
      },
      {
        "operation": "DELETE",
        "parent": "rdm/lookupTypes/OldRegion/Americas"
      }
    ],
    "attributes": [
      {
        "operation": "INSERT",
        "name": "Currency",
        "value": "USD"
      },
      {
        "operation": "UPDATE",
        "name": "Population",
        "value": "335000000"
      },
      {
        "operation": "DELETE",
        "name": "ObsoleteField",
        "value": "ObsoleteValue"
      }
    ]
  }
]

Unify and manage your data

Partial Update in RDM Lookups

HTTP method and endpoint

Set or preserve the lookup status

Modify multiple lookups codes in a single request

Example of all partial operations in one request

Footer