# Release Notes — 2.96 Covers the `2.96.x` Helm chart series. Most recent patch: **2.96.2**. _Unless a subsection says otherwise, changes apply to both Monad SaaS and self-hosted._ ## New features & improvements **SaaS & self-hosted** - **Monad built-in jq functions** — the jq transform now includes native `monad_` functions for common tasks: `monad_timestamp_to_epoch_ms` and `monad_timestamp_to_iso8601` (parse a timestamp in any common format), `monad_ocsf_severity_caption`, `monad_is_ip_address`, `monad_to_json_string`, and `monad_prune_empty` / `monad_prune_empty_keep_strings`. They run natively, so they are much faster than defining the same helpers in your query. Call them anywhere in a jq query. [Docs →](https://app.monad.com/docs/transforms/jq) (2.96.2) - **OpenAI Compliance Logs input: cron schedule** — a new optional Cron Schedule setting controls how often compliance logs are polled (every 5 minutes at most). Leave it blank to keep continuous polling. [Docs →](https://app.monad.com/docs/inputs/openai/openai-enterprise-compliance-logs) (2.96.2) - _Access:_ opt-in. Set **Cron Schedule** in the input's settings, for example `*/15 * * * *`. - **API list page sizes** — every API list endpoint now has a maximum page size: 1000 for v1 inputs and outputs and for v3 share targets, and 500 for every other list. A larger `limit` is lowered to the maximum instead of being rejected, and `pagination.limit` in the response shows the value applied. Scripts that need more rows than the maximum should page with `offset`. (2.96.2) **Self-hosted only** - **Multi-factor authentication and password change for the local admin** — installs using local authentication can protect the admin account with an authenticator app, recovery codes, and optionally one-time codes sent by email, and can change the admin password from the UI. [Docs →](https://app.monad.com/docs/guides/self-managed/authentication#multi-factor-authentication) (2.96.2) - _Access:_ opt-in. Sign in as the admin and open **User settings** from the user menu to change the password or enroll MFA. - Email codes need an SMTP Secret (`monad-kratos-smtp`) and `kratos.courier.enabled: true` in your values. ## Fixes - **Sign-in "Authentication error"** — starting a second sign-in in the same browser (another login tab, or the link after a password reset) no longer makes the first one fail with an Authentication error. The sign-in restarts and completes. (2.96.2) - **Cloudflare Access Login Events input** — no longer skips events after a full page of results, and now queries with the time window Cloudflare allows instead of always one hour. (2.96.2) - **Abnormal Security Cases input** — now ingests cases. Previously every case failed to parse and the input stopped at the first one. (2.96.2) - **OpenAI Compliance Logs input** — no longer downloads and re-sends the newest log file on every poll until a newer one appears. File downloads no longer time out when a low Rate limit is set. (2.96.2) - **Synthetic data toggle** — now appears on every input that can generate synthetic data, including Claude Code, Claude Cowork, MLflow GenAI traces, CloudWatch Logs Stream, Looker and Persona. Inputs that showed the toggle but failed with `error fetching template` now generate data. (2.96.2) - **API list paging** — paging through an API list no longer returns a row twice or skips one when rows share a name or creation time. Empty lists return `[]` instead of `null`. (2.96.2) - **API: unknown connector type** — type-schema endpoints return 404 instead of 500 for a type ID that doesn't exist. (2.96.2) - **Alert rule types API** — customer-managed alert types now report `managed_by: customer` instead of an empty value, so the Go SDK can decode the response. (2.96.2) ## Breaking changes **Self-hosted only** - **Local admin password: upgrade through 2.93 first** — if your install uses local authentication and runs a chart older than 2.93, upgrade to a 2.93 chart before upgrading to 2.96. Upgrading straight to 2.96 may lose the local admin password. (2.96.2) - **Gateway API TCP and TLS routes: upgrade Monad before your Gateway API CRDs** — applies only if you enable a route with `type: tcp` or `type: tls`. The chart now renders TCPRoute and TLSRoute at `gateway.networking.k8s.io/v1` when the cluster serves that version, and at the previous alpha version (`v1alpha2` / `v1alpha3`) otherwise. Upgrade Monad to 2.96.1 or later _before_ installing Gateway API CRDs v1.6 or later, which stop serving the alpha versions: Helm can't upgrade a release whose stored routes use a version the cluster no longer serves. If an upgrade already fails with `no matches for kind "TCPRoute" in version "gateway.networking.k8s.io/v1alpha2"`, set `served: true` on that version in the CRD, upgrade the release, then set it back. Use 2.96.1 or later rather than 2.96.0, which fails on CRDs older than v1.6. (2.96.1) ## Need help? See the [Monad docs](https://app.monad.com/docs) for setup guides and reference, or reach out to Monad Customer Support at [support@monad.com](mailto:support@monad.com) or via your dedicated Slack customer channel. :::note Self-hosted deployments upgrade to a `2.96.x` release with `helm upgrade`. Review the **Breaking changes** section above before upgrading; when it says "None," the upgrade is drop-in. :::