> For the complete documentation index, see [llms.txt](https://doc.wearepatchworks.com/product-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.wearepatchworks.com/product-documentation/release-information/core-release-notes/2023-09-21-release-notes-core.md).

# 2023 09 21 release notes (core)

## Release summary

The information detailed on this page refers to updates included in the following releases to the Patchworks Production environment:

**Patchworks core (backend)**

| Release version | Release date        |
| --------------- | ------------------- |
| 1.6.8           | 21st September 2023 |

**Patchworks dashboard (frontend)**

| Release version | Release date        |
| --------------- | ------------------- |
| 1.5.12          | 21st September 2023 |

New features, updates, and enhancements of note are summarised by product area, below:

* [Process flows](#process-flows)
* [Custom scripts](#custom-scripts)
* [Connectors & instances](#connectors-and-instances)
* [Prebuilt connectors](#prebuilt-connectors)

## Process flows

<table><thead><tr><th>Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Update" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option></select></th><th width="388">Summary</th><th>Version &#x26; Ref #</th></tr></thead><tbody><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>All-new dashboard home/overview page</strong><br>The dashboard home page has been overhauled - now you have more information at your fingertips to see how your process flows are performing and any actions required.<br><img src="/files/MexWutUpX0IvLKh7ZgY1" alt=""><a href="/pages/wNjaO0ghAqclvPQ6BaZw">The process flow home page</a></td><td>Core 1.6.8<br>Dashboard 1.5.12<br>CPT-234</td></tr><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>Tracked data</strong><br>When field tags are applied for the data schema associated with a connector endpoint, you can now choose if the field should be ‘tracked’.<br><img src="/files/MexWutUpX0IvLKh7ZgY1" alt=""><a href="/pages/wNjaO0ghAqclvPQ6BaZw#about-tracked-fields">About tracked fields</a></td><td>Core 1.6.8<br>CPT-975</td></tr><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>Process flow run failure email notifications</strong><br>You can now associate a notification group with a process flow so recipients receive an email notification in the event that a process flow run fails.<br><a href="/pages/RVdm7LuBhWXjhM0Cyuq9"><img src="/files/MexWutUpX0IvLKh7ZgY1" alt="" data-size="original"></a><a href="/pages/P8H0mCZRhnKQTC0KiQgd">Email notifications for process flow run failures</a></td><td>Core 1.6.8<br>Dashboard 1.5.12<br>CPT-125</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Lookup cache transform now accepts incoming transform value as the cache key</strong><br>When defining a lookup cache transform function you can now use the output from multi-stage transform as the key for the cache lookup.<br><img src="/files/MexWutUpX0IvLKh7ZgY1" alt=""><a href="/pages/egBLpC2Ogo7GaK36YWHW#using-output-from-a-transform-as-the-lookup-cache-key">Using output from a transform as the lookup cache key</a></td><td>Core 1.6.8<br>CPT-767</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Allow payload variables to be sourced from metadata</strong><br>It's now possible to target payload metadata in variables.<br><img src="/files/MexWutUpX0IvLKh7ZgY1" alt=""><a href="/pages/HC31VdrWhJMUz0LwmCJx#variables-and-parameters-from-payload-metadata">Variables &#x26; parameters from payload metadata</a></td><td>Core 1.6.8<br>CPT-780</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Run logs now show incoming payload from a webhook or inbound API call</strong><br>If a process flow receives data from a trigger webhook or an inbound API call, the associated payload can now be viewed in run logs.<br><a href="/pages/RVdm7LuBhWXjhM0Cyuq9"><img src="/files/MexWutUpX0IvLKh7ZgY1" alt="">Retrospective run logs</a></td><td>Core 1.6.8<br>Dashboard 1.5.12<br>CPT-753</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Real-time run logs now show body content for connection requests &#x26; responses</strong><br>The request and response tabs for real-time logs now show associated body content for a connection.<br><img src="/files/MexWutUpX0IvLKh7ZgY1" alt=""><a href="/pages/TNXwUbW0xLxu1LBHW23w">Real-time run logs</a></td><td>Core 1.6.8<br>Dashboard 1.5.12<br>CPT-924</td></tr><tr><td><span data-option="d8457d8925c74fab90fa132d141b764b">Update</span></td><td><strong>Retrospective run logs now show the last seven days by default</strong><br>When you access run logs, logs for the last 7 days are shown by default (previously the default showed logs for the last 12 hours).<br><a href="/pages/RVdm7LuBhWXjhM0Cyuq9"><img src="/files/MexWutUpX0IvLKh7ZgY1" alt="">Retrospective run logs</a></td><td>Core 1.6.8<br>Dashboard 1.5.12<br>CPT-752</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>The cache retention period can now be defined when a new cache is created</strong><br>When you drop an <em>add to cache</em> shape into a process flow and choose to create a new <em>flow-level</em> or <em>company-level</em> cache, you can now define when that cached data should expire. The maximum retention period is 7 days.<br><img src="/files/MexWutUpX0IvLKh7ZgY1" alt=""><a href="/pages/aGi157tdOz4wMkNdBOWh">Add to cache shape</a></td><td>Core 1.6.8<br>Dashboard 1.5.12<br>CPT-870</td></tr><tr><td><span data-option="d8457d8925c74fab90fa132d141b764b">Update</span></td><td><strong>The connector marketplace is now accessible from dashboard navigation bar</strong><br>You can now browse the connector marketplace straight from the left-hand navigation bar, using a new 'marketplace' option.<br><a href="/pages/RVdm7LuBhWXjhM0Cyuq9"><img src="/files/MexWutUpX0IvLKh7ZgY1" alt=""></a><a href="/pages/uVJlVUDxjvJi3MgSFEPB">The Patchworks marketplace</a></td><td>Dashboard 1.5.12<br>CPT-671</td></tr><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>New transform functions</strong><br>New transform functions include <em>Math</em>, <em>string to number</em>, <em>number to string</em>, <em>boolean to string</em>, and <em>null value</em>.<br><img src="/files/MexWutUpX0IvLKh7ZgY1" alt=""><a href="/pages/HDn9NDKmYejdH2cKYLTv">Available transform functions</a></td><td>Core 1.6.8<br>CPT-903<br>CPT-709</td></tr></tbody></table>

## Custom scripts

<table><thead><tr><th>Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Update" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option></select></th><th width="388">Summary</th><th>Version &#x26; Ref #</th></tr></thead><tbody><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Improved UI</strong><br>The custom script edit UI has had a facelift, with separate code and test panes.<br><a href="/pages/RVdm7LuBhWXjhM0Cyuq9"><img src="/files/MexWutUpX0IvLKh7ZgY1" alt="" data-size="original"></a><a href="/pages/NcpmiLm3yYTSW4ixRd2N">Adding &#x26; testing custom scripts</a></td><td>Core 1.6.8<br>CPT-642</td></tr><tr><td><span data-option="edbc33cea7f34e16b3a205c7a65c3172">New</span></td><td><strong>Variables can now be passed into custom scripts for testing</strong><br>When testing a custom script you can now pass in variables (and flow variables) as well as a payload for testing.<br><img src="/files/MexWutUpX0IvLKh7ZgY1" alt=""><a href="/pages/NcpmiLm3yYTSW4ixRd2N">Adding &#x26; testing custom scripts</a></td><td>Core 1.6.8<br>CPT-642</td></tr></tbody></table>

## Connectors & instances

<table><thead><tr><th>Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Update" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option></select></th><th width="388">Summary</th><th>Version &#x26; Ref #</th></tr></thead><tbody><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>More information for invalid credentials</strong><br>If credentials cannot be validated when an instance is added, a <em>more details</em> option is provided so you can view the authentication request and response.<br><a href="/pages/RVdm7LuBhWXjhM0Cyuq9"><img src="/files/MexWutUpX0IvLKh7ZgY1" alt="" data-size="original"></a><a href="/pages/8b0V4AbjjCtqyMhraqE5">Adding an instance</a></td><td>Core 1.6.8<br>Dashboard 1.5.12<br>CPT-643</td></tr></tbody></table>

## Prebuilt connectors

The following prebuilt connectors have been added to the Patchworks marketplace:

<div align="left"><figure><img src="/files/UObjMEOvdPUmUwNJxd9R" alt="" width="76"><figcaption></figcaption></figure> <figure><img src="/files/u0JpxJNcKRW9alizwnWJ" alt="" width="75"><figcaption></figcaption></figure> <figure><img src="/files/oE9ZbZXEnehJ1sJq0j1C" alt="" width="75"><figcaption></figcaption></figure> <figure><img src="/files/5u0CdEx0JpFRmRiER083" alt="" width="75"><figcaption></figcaption></figure> <figure><img src="/files/ZaRHmvtyt6H622IGBkD0" alt="" width="76"><figcaption></figcaption></figure> <figure><img src="/files/ho6PaRNMZewmofe6MeaN" alt="" width="75"><figcaption></figcaption></figure></div>
