# 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/iJTVV3IggPEOZLyAOQdc" alt="" width="75"><figcaption></figcaption></figure> <figure><img src="/files/gkrc2fbptrKlpY8mdjTk" alt="" width="76"><figcaption></figcaption></figure> <figure><img src="/files/YwzaOxs26V6w9FtTsTAu" alt="" width="75"><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.wearepatchworks.com/product-documentation/release-information/core-release-notes/2023-09-21-release-notes-core.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
