Partial Updates for Localization

Learn how to use partial operations to add, update, or delete localized translations for lookup values without replacing the entire lookup definition.

Localizations are language-specific translations used to display lookup values in different languages across the Reltio platform. They improve clarity and usability by allowing users to work with data in their preferred language.

You can manage translations using the following partial update operations:

INSERT - to add a new translation
UPDATE- to modify an existing translation
DELETE - to delete an outdated or incorrect translation

Each operation applies to a specific languageCode and requires a value to be processed correctly.You can include multiple operation types in a single request, making it possible to insert, update, and delete localization values within the same payload.

INSERT - Add a new localization

Use the INSERT operation to add a new localized label for a specific language. This operation lets you introduce a new translation for a lookup value without modifying existing localizations. The table below describes the request body parameters for this operation.


Parameter	Type	Required	Description	Default Value	Accepted values
`operation`	String	Yes	Specifies the operation type.	None	"INSERT"
`languageCode`	String	Yes	Language and region code for the translation.	None	"en-GB"
`value`	String	Yes	Translated lookup value.	None	"Estados Unidos"

Example request for INSERT operation

{
  "operation": "INSERT",
  "languageCode": "es-ES",
  "value": "Estados Unidos",
  "description": "United States in Spanish"
}

UPDATE - Modify the attributes of an existing localization

Use this operation to modify an existing localization.Each languageCode must already exist and serves as the unique identifier for the localization being updated. Requests cannot contain duplicate language codes. The following table describes the request body parameters for this operation.


Parameter	Type	Required	Description	Default Value	Accepted values
`operation`	String	Yes	Specifies the operation type.	None	"UPDATE"
`languageCode`	String	Yes	Language code to identify the localization to update.	None	"en-GB"
`value`	String	Yes	Updated translation.	None	"Estados Unidos de América"
`description`	String	No	Updated description.	None	"Updated Spanish translation"

Example request for UPDATE operation

{
  "operation": "UPDATE",
  "languageCode": "es-ES",
  "value": "Estados Unidos de América",
  "description": "Updated Spanish translation"
}

DELETE - Remove an existing localization

Use this operation to delete a translation that is outdated, incorrect, or no longer required. All fields must match the existing entry exactly. The following table describes the request body parameters for the DELETE operation, which removes a localized label for a given language.


Parameter	Type	Required	Description	Default Value	Accepted values
`operation`	String	Yes	Specifies the operation type.	None	"DELETE"
`languageCode`	String	Yes	Language code of the localization to delete.	None	"en-GB"
`value`	String	Yes	The exact translation to be deleted.	None	"Estados Unidos"
`description`	String	No	Description that matches the translation for deletion.	None	"United States in Spanish"

Example request for DELETE operation

{
  "operation": "DELETE",
  "languageCode": "es-ES",
  "value": "Estados Unidos",
  "description": "United States in Spanish"
}

Using multiple localization operations in a single request

This example shows how to perform multiple localization updates on a single reference data value. The request targets the Country lookup type in the Reference Data Management (RDM) tenant and includes:

Inserting a new localized value
Updating an existing translation
Deleting a specific language entry

Request Body

[
  {
    "tenantId": "{{rdm_tenant}}",
    "type": "rdm/lookupTypes/Country",
    "code": "US",
    "localizations": [
      {
        "operation": "INSERT",
        "languageCode": "fr-FR",
        "value": "États-Unis",
        "description": "United States in French"
      },
      {
        "operation": "UPDATE",
        "languageCode": "es-ES",
        "value": "Estados Unidos de América",
        "description": "Updated Spanish translation"
      },
      {
        "operation": "DELETE",
        "languageCode": "de-DE",
        "value": "Vereinigte Staaten",
        "description": "United States in German"
      }
    ]
  }
]

Unify and manage your data

Partial Updates for Localization

INSERT - Add a new localization

UPDATE - Modify the attributes of an existing localization

DELETE - Remove an existing localization

Using multiple localization operations in a single request

Footer