Partial Updates for Parents

Learn how to use partial operations to add or remove hierarchical parent relationships for lookup codes without replacing the full lookup definition.

Parents define hierarchical relationships between lookup codes in Reltio Reference Data Management (RDM). These relationships represent real-world groupings, for example, linking a country to a region or continent.

To manage parent associations, use partial update operations. Only two operations are supported:

INSERT - to add a new parent
DELETE - to delete an existing parent

Note: The UPDATE operation is not supported for parent objects. To replace an existing parent, INSERT the new parent and DELETE the old one within the same request.

You can include multiple parents operations in a single request payload.

INSERT - Add a new parent value

Use the INSERT operation to add a new parent to a lookup code. This operation creates a hierarchical association between the current (child) lookup value and a specified parent entity. 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	"INSERT"
`parent`	String	Yes	URI of the parent lookup code to associate.	None	"rdm/lookupTypes/Continent/NA"

Example request for INSERT operation

{
  "operation": "INSERT",
  "parent": "rdm/lookupTypes/Continent/NA"
}

DELETE - Remove an existing parent value

Use the DELETE operation to remove an existing parent from a lookup code. The specified parent URI must match exactly for the operation to succeed. 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	"DELETE"
`parent`	String	Yes	URI of the parent lookup code to remove.	None	"rdm/lookupTypes/Continent/NA"

Example request for DELETE operation

{
  "operation": "DELETE",
  "parent": "rdm/lookupTypes/Continent/NA"
}

Insert and delete parent values in a single request

The following example demonstrates how to insert and delete parents for a single lookup value in one request payload.

[
  {
    "tenantId": "{{rdm_tenant}}",
    "type": "rdm/lookupTypes/Country",
    "code": "US",
    "parents": [
      {
        "operation": "INSERT",
        "parent": "rdm/lookupTypes/Region/Americas"
      },
      {
        "operation": "DELETE",
        "parent": "rdm/lookupTypes/Continent/NA"
      }
    ]
  }
]

Unify and manage your data

Partial Updates for Parents

INSERT - Add a new parent value

DELETE - Remove an existing parent value

Insert and delete parent values in a single request

Footer