---
updatedAt: 2025-12-15T13:10:03.000Z
agentTools:
  projectIndex: https://cloud.docs.tamr.com/llms.txt
---

# Relationships Changelog

# Version: v1apha1

**Initial Release** 2024-11-18

**Stability Level** Early Access

See [Versioning](https://cloud.docs.tamr.com/tamr-cloud/reference/versioning) for more information on Tamr's API versioning policies.

**Changelog:**

[block:html]
{
  "html": "<table>\n  <tr>\n    <th width=\"60%\">Change Summary</th>\n    <th width=\"20%\">Type</th>\n    <th width=\"20%\">Date</th>\n  </tr>\n   <tr><td><p><b>Added optional <code>fromRecordVersion</code> and <code>toRecordVersion</code> objects to the body of the\n <a href=\"https://cloud.docs.tamr.com/reference/relationships_createrelationship\" \ntarget=\"_blank\">\n   create </a> and <a href=\"https://cloud.docs.tamr.com/reference/relationships_updaterelationship\" \ntarget=\"_blank\">\n   update </a> relationship operations</b></p>\n      <p>\nIf these versions are specified, the operation is performed only if the current version of the to and/or from records match the specified versions.</p>\n    </td>\n    <td>Additive</td>\n    <td>2024-12-09</td>\n  </tr>\n  <tr><td><p><b>Added optional <code>expectedVersion</code> query parameter to the\n <a href=\"https://cloud.docs.tamr.com/reference/relationships_deleterelationship\" \ntarget=\"_blank\">\n   delete relationship operation</a></b></p>\n      <p>\nIf the expected version of the relationship is specified, the operation is performed only \n        if the current version of the relationship matches the specified version.</p>\n    </td>\n    <td>Additive</td>\n    <td>2024-12-02</td>\n  </tr>\n    <tr><td><p><b>Added optional <code>details</code> body object parameter to the <a href=\"https://cloud.docs.tamr.com/reference/relationships_createrelationship\" \ntarget=\"_blank\">\n   create relationship</a> and\n <a href=\"https://cloud.docs.tamr.com/reference/relationships_updaterelationship\" \ntarget=\"_blank\">\n   update relationship</a> operations</b></p>\n      <p>In this object, provide additional details about the relationship in the form of \nkey/value pairs.</p>\n      <p>This new object is also returned in responses for the following operations:</p>\n        <ul><li><a href=\"https://cloud.docs.tamr.com/reference/relationships_createrelationship\" \ntarget=\"_blank\">\n       create relationship</a></li>\n       <li><a href=\"https://cloud.docs.tamr.com/reference/relationships_updaterelationship\" \ntarget=\"_blank\">\n         update relationship</a></li>\n          <li><a href=\"https://cloud.docs.tamr.com/reference/relationships_getrelationship\" \ntarget=\"_blank\">\n         get relationship</a></li>\n         <li><a href=\"https://cloud.docs.tamr.com/reference/relationships_listrelationships\" \ntarget=\"_blank\">\n         list relationships</a></li>  \n           <li><a href=\"https://cloud.docs.tamr.com/reference/relationships_deleterelationship\" \ntarget=\"_blank\">\n         delete relationship</a></li>\n      </ul>\n      \n    </td>\n    <td>Additive</td>\n    <td>2024-12-02</td>\n\n</table>\n  "
}
[/block]