# 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.&#x20;

| 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></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>


---

# 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/2025-09-17-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.