> 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="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="/product-documentation/process-flows/the-process-flows-overview-page.md">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="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="/product-documentation/process-flows/the-process-flows-overview-page.md#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="/product-documentation/process-flows/error-reporting-and-exception-handling/run-logs-and-queue.md"><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt="" data-size="original"></a><a href="/product-documentation/process-flows/error-reporting-and-exception-handling/email-notifications-for-failed-process-flow-runs.md">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="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="/product-documentation/process-flows/building-process-flows/process-flow-shapes/advanced-shapes/cache/referencing-a-cache-in-mapping-transformations.md#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="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="/product-documentation/process-flows/building-process-flows/dynamic-variables/payload-variables.md#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="/product-documentation/process-flows/error-reporting-and-exception-handling/run-logs-and-queue.md"><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" 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="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="/product-documentation/process-flows/error-reporting-and-exception-handling/real-time-run-logs.md">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="/product-documentation/process-flows/error-reporting-and-exception-handling/run-logs-and-queue.md"><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" 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="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="/product-documentation/process-flows/building-process-flows/process-flow-shapes/advanced-shapes/cache/add-to-cache-shape.md">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="/product-documentation/process-flows/error-reporting-and-exception-handling/run-logs-and-queue.md"><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""></a><a href="/product-documentation/marketplace/the-patchworks-marketplace.md">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="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/map-shape/working-with-field-transformations/available-transform-functions.md">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="/product-documentation/process-flows/error-reporting-and-exception-handling/run-logs-and-queue.md"><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt="" data-size="original"></a><a href="/product-documentation/developer-hub/custom-scripting/creating-and-testing-custom-scripts.md">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="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt=""><a href="/product-documentation/developer-hub/custom-scripting/creating-and-testing-custom-scripts.md">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="/product-documentation/process-flows/error-reporting-and-exception-handling/run-logs-and-queue.md"><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F7ebRB4tRIozWxpBMCAoN%2Ficons8-google-docs-20.svg?alt=media&amp;token=ac61da4e-764c-452c-b9b5-d65f188769c9" alt="" data-size="original"></a><a href="/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance.md">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="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Frs938CLp6qAKenYihJnX%2Fcybertill2.svg?alt=media&amp;token=1385e7a3-4a2b-4f8b-97cc-eeba628619b0" alt="" width="76"><figcaption></figcaption></figure> <figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Fp43z13RT1SiH4bX6Zu1Q%2FDeposco.svg?alt=media&amp;token=d0103b2a-f61f-49a7-9b06-9dc2f95ef8ba" alt="" width="75"><figcaption></figcaption></figure> <figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FqYA3AGbvds1GZ8Tgyjd2%2Fonbuy.svg?alt=media&amp;token=0b2db8ae-1ddc-4630-8c8c-bf690b18d729" alt="" width="75"><figcaption></figcaption></figure> <figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FB9Y4IHAMyCjiRAvziXyE%2Fjohnlewis.svg?alt=media&amp;token=2bba078d-2518-4b34-a2c4-f180ab65c3aa" alt="" width="75"><figcaption></figcaption></figure> <figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FiaNeRMK16zRNj0e1p4R4%2Frebound.svg?alt=media&amp;token=ac56be45-fb8d-45b5-9595-82f4b5894603" alt="" width="76"><figcaption></figcaption></figure> <figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Fp9XXxiCIuGoAND2jkKBc%2Fklaviyo.svg?alt=media&amp;token=769db5ec-73c7-453e-83c4-14dac3d04f21" alt="" width="75"><figcaption></figcaption></figure></div>
