> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# FlowX.AI 5.9.7 Release Notes (LTS)

> 5.9.x LTS maintenance release: Prometheus ServiceMonitor fixes, audit index retention, Kafka options in the flowx-ai Helm chart, and security patches.

> [!NOTE]
>
> This is a **Long-Term Support (LTS)** maintenance release in the **5.9.x** line, focused on **bug fixes**, **security patches**, and **stability improvements**. Review the [deployment guidelines](https://docs.flowx.ai/release-notes/v5.x/v5.9.7-november-2026/deployment-guidelines-v5.9.7.md) before you upgrade: one Helm value for Prometheus relabeling is renamed.

> [card] Release Highlight
>
> **FlowX.AI 5.9.7** is a maintenance release for the 5.9.x LTS:
>
> * **Prometheus metrics:** the `ServiceMonitor` resources of the FlowX Helm charts select the management Service and scrape its metrics path, so Prometheus collects service metrics
> * **Key fixes:** reusable functions resolve when an overriding process runs as an embedded subprocess, and an error boundary event moves the token on during asynchronous advancing
> * Audit index retention settings, more Kafka connection options in the `flowx-ai` Helm chart, and security patches. Every change is listed in the [full changelog](#full-changelog)

***

## Upgrade notes

> [!NOTE]
>
> **Upgrade compatibility:** FlowX.AI 5.9.7 is compatible with 5.9.6. No database migration and no new Kafka topics.
>
> **Zero-downtime upgrade:** supported, after the steps below. See [Upgrade within an LTS family](https://docs.flowx.ai/5.9/setup-guides/upgrade-within-lts-family.md).

**Before you upgrade, check these:**

* **Prometheus relabeling:** the Helm charts no longer read `metrics.serviceMonitor.relabellings`. If you set it, move the rules to `metrics.serviceMonitor.metricRelabelings`, applied before ingestion, or to `metrics.serviceMonitor.relabelings`, applied before the scrape. See [Prometheus ServiceMonitor](https://docs.flowx.ai/release-notes/v5.x/v5.9.7-november-2026/deployment-guidelines-v5.9.7.md#prometheus-servicemonitor).
* **API description endpoints:** the services no longer serve the Swagger UI or the OpenAPI description at `/swagger-ui` and `/v3/api-docs`. Update any tooling or ingress rules that read them.
* **Text Parsing:** the Text Parsing strategy of the document parser no longer runs OCR by default. Scanned pages that have no text layer return no text: use an OCR or LLM strategy for them.
* **SpiceDB CRD with Argo CD or several releases per cluster:** the SpiceDB CRD moved to its own Helm subchart with a new `spicedb-operator-crds.enabled` value. With Argo CD, upgrade with the value left at `true` before you set it to `false` anywhere. See [SpiceDB CRD](https://docs.flowx.ai/release-notes/v5.x/v5.9.7-november-2026/deployment-guidelines-v5.9.7.md#spicedb-crd).

**Upgrade path:** direct upgrade from 5.9.6. Upgrading from 5.9.5 or earlier? Review the [5.9.6 deployment guidelines](https://docs.flowx.ai/release-notes/v5.x/v5.9.6-october-2026/deployment-guidelines-v5.9.6.md) first.

**Component compatibility:** compatible with FlowX.AI SDKs (Angular/React/React Native/iOS/Android) and Designer 5.9.x. Component versions are listed in the [5.9.7 deployment guidelines](https://docs.flowx.ai/release-notes/v5.x/v5.9.7-november-2026/deployment-guidelines-v5.9.7.md).

***

## Full changelog

### New

* **Audit:** set how long audit data is kept, and roll audit indices over when a primary shard reaches a set size, with two new environment variables. Both are off by default, so the Audit service deletes nothing until you set a retention period. See [Configuring Elasticsearch](https://docs.flowx.ai/5.9/setup-guides/audit-setup-guide.md#configuring-elasticsearch) and [Audit index retention](https://docs.flowx.ai/release-notes/v5.x/v5.9.7-november-2026/deployment-guidelines-v5.9.7.md#audit-index-retention).&#x20;
* **flowx-ai Helm chart:** Kafka connections support SASL `PLAIN`, for example a Confluent Cloud API key over TLS. TLS without `tls.existingSecret` trusts the CA bundle of the image. OAuth can use an identity provider for Kafka only, Keycloak or Microsoft Entra ID, with its own scope and SASL extensions. The AI services receive the same settings. See [How do I connect to Kafka with SASL?](https://docs.flowx.ai/5.9/setup-guides/configure-flowx-ai-helm-chart.md#how-do-i-connect-to-kafka-with-sasl).&#x20;

### Changed

* **Document parser:** the Text Parsing strategy reads the text layer only and no longer runs OCR by default. Text parsing of DOCX files no longer fails while it looks for OCR language data.&#x20;
* **Helm charts:** the SpiceDB CRD ships in its own `spicedb-operator-crds` subchart, which a new `spicedb-operator-crds.enabled` value turns off where another release or tool owns the CRD. Argo CD no longer prunes or deletes the CRD. See [SpiceDB CRD](https://docs.flowx.ai/release-notes/v5.x/v5.9.7-november-2026/deployment-guidelines-v5.9.7.md#spicedb-crd).&#x20;
* **Helm charts:** Prometheus relabel rules are read from `metrics.serviceMonitor.relabelings` and `metrics.serviceMonitor.metricRelabelings`. The misspelled `metrics.serviceMonitor.relabellings` key is no longer read. See [Prometheus ServiceMonitor](https://docs.flowx.ai/release-notes/v5.x/v5.9.7-november-2026/deployment-guidelines-v5.9.7.md#prometheus-servicemonitor).&#x20;

### Fixed

* **Helm charts:** the `ServiceMonitor` of each service selects the management Service and scrapes `/manage/actuator/prometheus` on the `mngt` port, so Prometheus collects metrics instead of finding no target or getting a 404.&#x20;
* **Process engine:** a process that overrides a library process and runs as an embedded subprocess finds its reusable functions, and its nodes run in the overriding application's build. Business rules no longer fail because `functions` is not defined.&#x20;
* **Process engine:** an error boundary event that catches an error during asynchronous advancing moves the token to its outgoing path, instead of leaving the token on the task.&#x20;
* **Media Library:** importing a ZIP file into the Global Media Library from Windows no longer fails with a parsing error.&#x20;
* **Error responses:** an unexpected server error returns a generic message and an `errorId` instead of the exception message, and the service logs the full error with the same `errorId`. When a business rule, reusable function, or gateway condition that you test from FlowX Designer fails, the script error comes back with status 422, so Designer still shows it.&#x20;
* Stability fixes across project version merges, embedded subprocesses, the events gateway, the renderers, and the AI services.

### Removed

* **All services:** the Swagger UI and the OpenAPI description, `/swagger-ui` and `/v3/api-docs`, are no longer served.&#x20;

### Security

* **All components:** security patches and dependency upgrades to address known vulnerabilities.&#x20;


## Related topics

- [FlowX.AI 5.9.x LTS changelog](https://docs.flowx.ai/release-notes/v5.x/5.9-lts-changelog.md)
- [FlowX.AI 5.1.1 Release Notes (LTS)](https://docs.flowx.ai/release-notes/v5.x/v5.1.x-lts/v5.1.1-november-2025.md)
- [FlowX.AI 5.1.5 Release Notes (LTS)](https://docs.flowx.ai/release-notes/v5.x/v5.1.x-lts/v5.1.5-february-2026.md)
- [FlowX.AI 5.1.7 Release Notes (LTS)](https://docs.flowx.ai/release-notes/v5.x/v5.1.x-lts/v5.1.7-march-2026.md)
- [FlowX.AI 5.1.8 Release Notes (LTS)](https://docs.flowx.ai/release-notes/v5.x/v5.1.x-lts/v5.1.8-april-2026.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.