> 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/2025-09-17-release-notes-core.md).

# 2025 09 17 release notes (core)

## Release summary <a href="#release-summary" id="release-summary"></a>

This page summarises items scheduled for the following release to the Patchworks Core Production environment.

| Release version | Release date              |
| --------------- | ------------------------- |
| v2025-09-17     | 17th September 2025 (a.m) |

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

* [Company registration](#company-registration)​
* [Process flows](#process-flows)
* [Virtual environments](#virtual-environments)
* [Connector builder](#connector-builder)
* [Blueprints](#blueprints)
* [Multi-company profiles](#blueprints)

## Company registration

<table><thead><tr><th width="180">Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Change" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option><option value="L09Gy6z2y7VD" label="Breaking change" color="blue"></option></select></th><th width="426">Summary</th><th>Ref #</th></tr></thead><tbody><tr><td><span data-option="d8457d8925c74fab90fa132d141b764b">Change</span></td><td><strong>Registering for a trial account</strong><br>The process for registering a trial account has changed. Now, users are directed to our request a trial page - here they can enter company details and schedule a brief meeting with Patchworks to discuss requirements and initiate a trial.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/17xE4wxunAFfT2ZGh0NK">Registering for a Patchworks account</a></td><td>CPT-4589</td></tr></tbody></table>

## Process flows <a href="#process-flows" id="process-flows"></a>

<table><thead><tr><th width="180">Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Change" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option><option value="L09Gy6z2y7VD" label="Breaking change" color="blue"></option></select></th><th width="426">Summary</th><th>Ref #</th></tr></thead><tbody><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>View payload metadata at each stage in a flow run</strong><br>A new <code>metadata</code> tab has been added to the process flow run details panel so you can view payload metadata at each step of a run.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/TNXwUbW0xLxu1LBHW23w">Real-time run logs</a></td><td>CPT-4575</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Create caches from the data caches page</strong><br>Previously, new caches could only be created via an <a href="/pages/aGi157tdOz4wMkNdBOWh">add to cache shape</a> in process flows. Now you can also use <code>create cache</code> options from the <code>data caches</code> page - you'll find this option for each cache type.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/DdokBDqbVx1igRoa230c">Cache maintenance</a></td><td>CPT-4549</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><p><strong>Callback shape authentication</strong><br>By default, callback URLs include a Patchworks signature, which is passed as a URL parameter. However, some third-party systems don't allow URL parameters, stripping them out when found.</p><p>To handle this scenario, we now pass the signature in as a <code>patchworks_signature</code> header, if no signature is found in the URL.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/pjs69xcYUPTKrvyb5yvA">Callback triggers</a></p></td><td>CPT-4725</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Run logs</strong><br>Performance improvements for loading run logs.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/eQlwxkMV399goBsq2RIz">Run logs</a></td><td>CPT-4798</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Substring transform function</strong><br>Fixed an issue where the substring transform function was not allowing negative offsets.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/O9uezsZcvXOrrgea0Wpe">The substring transform function</a></td><td>CPT-3099</td></tr></tbody></table>

## Virtual environments

<table><thead><tr><th width="180">Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Change" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option><option value="L09Gy6z2y7VD" label="Breaking change" color="blue"></option></select></th><th width="426">Summary</th><th>Ref #</th></tr></thead><tbody><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Ability to replace 'flow' caches</strong><br><code>flow</code> type caches are now available when selecting cache replacements for a virtual environment (previously, only <code>company</code> caches could be replaced).<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/q0Rl0efFGkbxrzkUaDQv">Replacement caches</a></td><td>CPT-4549</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Add (and sort by) labels</strong><br>When creating a virtual environment, you can now apply labels. When <a href="/pages/mOQQBxbQqCqhuToig0h0">viewing available virtual environments</a>, a new label filter option is available.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/lxN198TPnYYhQcoOm9g6">Creating a virtual environment</a></td><td>CPT-4498</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Advanced run from process flow canvas</strong><br>The advanced run option has been enhanced, allowing you to override environment variables for the selected virtual environment OR add new (temporary) environment variables if no virtual environment is chosen.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/dbbScpcqaq153JRToy7B">Testing a process flow against a virtual environment</a></td><td>CPT-4694</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Warning before virtual environment removal</strong><br>Choosing to delete a virtual environment now displays a confirmation message, so users must confirm the action before the removal happens.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/ERYQfe1LNMTvQhQJZA3G">Deleting a virtual environment</a></td><td>CPT-4449</td></tr><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><p><strong>Adding flow versions to packages</strong></p><p>When choosing which version of a process flow to add to a package, you can now see the current status of the flow version (<code>draft</code>, <code>deployed</code>, <code>inactive</code>) as well as the version number.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/uFsfgRfHPmzyyP57WWSM">Creating a package</a></p></td><td>CPT-4375</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>View deployments display</strong><br>Fixed a refresh issue where the view deployments modal was not updating to show a new deployment.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/QJn3I6Ens3cFWBGOJZMh">Deploying a single process flow to a virtual environment</a></td><td>CPT-4517</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Delete draft virtual environment version</strong><br>Fixed a refresh issue where the option to create a new virtual environment <code>draft</code> version was not displayed immediately after deleting the existing draft.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/v5m0RGTNq6uSlxj0uPCY">Deleting a virtual environment version</a></td><td>CPT-4450</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Run process flow shape in virtual environments</strong><br>Fixed validation to ensure that the process flow called from a run process flow shape must exist in the same environment as the 'parent' flow - if not, the shape fails and an error is given.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/1YdpDOKiycGviDZd7krP">Run process flow shape</a></td><td>CPT-4693</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Missing</strong> <strong>environment variables for new draft versions</strong><br>Fixed an issue where environment variables present in a <code>deployed</code> virtual environment were missing in new <code>draft</code> versions created from that version.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/FSy5zH8LDQpKxEVCzror">Updating a virtual environment version</a></td><td>CPT-4488</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Environment variables passed as connector variable values</strong><br>Fixed an issue where environment variables were not resolved correctly when passed as connector variable values.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/LenK8OCLW7pjUzWD6OSI">Replacement variables</a></td><td>CPT-4536</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Cross-reference lookup duplication</strong><br>Fixed an issue where cross-reference lookups could be duplicated when a blueprint was installed.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/jfpe0I4JN0aeeuKW4KyA">Blueprints</a></td><td>CPT-4730</td></tr></tbody></table>

## Connector builder

<table><thead><tr><th width="180">Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Change" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option><option value="L09Gy6z2y7VD" label="Breaking change" color="blue"></option></select></th><th width="426">Summary</th><th>Ref #</th></tr></thead><tbody><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Multiple occurrences of the same endpoint variable</strong><br>Fixed an issue where defining the same endpoint variable multiple times (i.e. sending array elements in the form <code>my_variable[]</code> ) resulted in only the first variable being sent in requests.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/NkagMrYpKNNL9YbPDcsq">Endpoint variables</a></td><td>CPT-3921</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>OAuth redirects for API keys</strong><br>Fixed an issue where creating OAuth-based connectors via the API failed (because redirects back to Patchworks no longer contained API keys passed in the original request).<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/jfpe0I4JN0aeeuKW4KyA">Blueprints</a></td><td>CPT-4683</td></tr></tbody></table>

## Blueprints

<table><thead><tr><th width="180">Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Change" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option><option value="L09Gy6z2y7VD" label="Breaking change" color="blue"></option></select></th><th width="426">Summary</th><th>Ref #</th></tr></thead><tbody><tr><td><span data-option="030babd6286a4fe19214da74af9afb98">Enhancement</span></td><td><strong>Add (and sort by) labels</strong><br>When creating a blueprint, you can now apply labels. When viewing your blueprints, a new label filter option is available.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/jfpe0I4JN0aeeuKW4KyA">Blueprints</a></td><td>CPT-4498</td></tr><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Cross-reference lookup duplication</strong><br>Fixed an issue where cross-reference lookups could be duplicated when a blueprint was installed.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/jfpe0I4JN0aeeuKW4KyA">Blueprints</a></td><td>CPT-4730</td></tr></tbody></table>

## Multi-company profiles

<table><thead><tr><th width="180">Type<select><option value="edbc33cea7f34e16b3a205c7a65c3172" label="New" color="blue"></option><option value="d8457d8925c74fab90fa132d141b764b" label="Change" color="blue"></option><option value="030babd6286a4fe19214da74af9afb98" label="Enhancement" color="blue"></option><option value="9a29ee576f43448f9b1623baca59c3db" label="Bug" color="blue"></option><option value="L09Gy6z2y7VD" label="Breaking change" color="blue"></option></select></th><th width="426">Summary</th><th>Ref #</th></tr></thead><tbody><tr><td><span data-option="9a29ee576f43448f9b1623baca59c3db">Bug</span></td><td><strong>Company insights</strong><br>Fixed an issue where totals were displayed incorrectly for managed companies.<br><img src="/files/j1i0cLEEKzAu7FBcGQmn" alt="" data-size="line"> <a href="/pages/oJ1nCe1ZO73MaYLF9m0Z">Company insights</a></td><td>CPT-4555</td></tr></tbody></table>
