> For the complete documentation index, see [llms.txt](https://docs.prestd.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.prestd.com/releases.md).

# Releases

**Latest v2 release:** [v2.6.0](https://docs.prestd.com/releases/v2.6.0.md) (18 Nov 2026) — feature release: request IDs (`http.request_id_header`), `pg.application_name`, MCP `protocolVersion` negotiation, `PREST_CONFIG_JSON`, `http.allowed_hosts`, `pg.timezone`, a configurable `/auth` token lifetime (`auth.token_ttl`), `prestd auth create-user`, `$contains` on array columns, and `rows`/`columns`/msgpack renderers. It fixes no security advisory and includes every v2.5.3 fix.

For stable v1 releases, see [GitHub Releases](https://github.com/prest/prest/releases/latest).

## Unreleased (main)

Work merged after v2.6.0 is listed in [Changes since v2.6.0](https://docs.prestd.com/releases/main-since-v2.6.0.md).

## v2.6.0 highlights

| Area     | Change                                                                                                                                                                                                                           |
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| HTTP     | Request IDs on every response and access-log line with `http.request_id_header` ([#1114](https://github.com/prest/prest/pull/1114))                                                                                              |
| HTTP     | `http.allowed_hosts` answers **400** to requests for other hosts ([#1107](https://github.com/prest/prest/pull/1107))                                                                                                             |
| Postgres | `pg.application_name` names pREST's connections, default `prestd` ([#1091](https://github.com/prest/prest/pull/1091)); `pg.timezone` sets the session time zone ([#1106](https://github.com/prest/prest/pull/1106))              |
| MCP      | `initialize` negotiates `protocolVersion` and accepts unknown request fields ([#1117](https://github.com/prest/prest/pull/1117))                                                                                                 |
| Config   | `PREST_CONFIG_JSON` and `prestd config export-json` ([#1100](https://github.com/prest/prest/pull/1100))                                                                                                                          |
| Auth     | `auth.token_ttl` ([#1097](https://github.com/prest/prest/pull/1097)) and `prestd auth create-user` ([#1102](https://github.com/prest/prest/pull/1102))                                                                           |
| API      | `$contains` on array columns ([#1094](https://github.com/prest/prest/pull/1094)); `rows`, `columns` and msgpack renderers ([#1104](https://github.com/prest/prest/pull/1104), [#1105](https://github.com/prest/prest/pull/1105)) |
| Fixes    | `_returning` errors no longer panic ([#1103](https://github.com/prest/prest/pull/1103)); only a leading `$op` is an operator ([#1093](https://github.com/prest/prest/pull/1093))                                                 |
| Build    | `go.mod` declares Go 1.27; `make deps-upgrade` ([#1119](https://github.com/prest/prest/pull/1119))                                                                                                                               |

See [v2.6.0 release notes](https://docs.prestd.com/releases/v2.6.0.md) and [Changes since v2.5.3 (in v2.6.0)](https://docs.prestd.com/releases/main-since-v2.5.3.md). Before upgrading, read [Upgrading from v2.5.3](https://docs.prestd.com/releases/v2.6.0.md#upgrading-from-v253).

## v2.5.3 highlights

| Area     | Change                                                                                                                                                                                                              |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Security | `DELETE`, `PUT`, and `PATCH` with no filter are **400**; `[access] allow_unscoped_writes` opts out — high, CVSS 8.1 ([GHSA-r867-ghgv-mrp9](https://github.com/prest/prest/security/advisories/GHSA-r867-ghgv-mrp9)) |
| Security | `_count` and every column a read filters, orders, or groups by must be readable — high, CVSS 7.5 ([GHSA-48r9-g6f9-x3gm](https://github.com/prest/prest/security/advisories/GHSA-48r9-g6f9-x3gm))                    |
| Security | Write bodies may set only the columns in `fields`; write responses show only readable columns — high, CVSS 7.1 ([GHSA-h25q-9rmj-646h](https://github.com/prest/prest/security/advisories/GHSA-h25q-9rmj-646h))      |

See [v2.5.3 release notes](https://docs.prestd.com/releases/v2.5.3.md) and [Changes since v2.5.2](https://docs.prestd.com/releases/main-since-v2.5.2.md). **Upgrade from v2.5.2 or earlier now** (v2.6.0 includes these fixes), and check clients that write without a filter or use columns outside `fields`.

## v2.5.2 highlights

| Area           | Change                                                                                                                                                                                                                                                                                         |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Security       | Reserved control-plane tables (`prest_queries`, `prest_users`) blocked on REST, `_join`, and MCP — critical, CVSS 9.0 ([GHSA-2x9q-r7j9-g85f](https://github.com/prest/prest/security/advisories/GHSA-2x9q-r7j9-g85f))                                                                          |
| Security       | Catalog routes and `/show` behind auth and table ACL — high, CVSS 7.5 ([GHSA-fhf5-m388-4w4p](https://github.com/prest/prest/security/advisories/GHSA-fhf5-m388-4w4p))                                                                                                                          |
| Security       | `/_PLUGIN` name confinement and auth — high, CVSS 8.1 ([GHSA-fmr6-9j48-xrqp](https://github.com/prest/prest/security/advisories/GHSA-fmr6-9j48-xrqp))                                                                                                                                          |
| Multi-database | `pg.single` removed; `pg.allowed_databases`; unreachable aliases answer 503 instead of stopping startup ([#1068](https://github.com/prest/prest/pull/1068)); co-authored by [@samithiwat](https://github.com/samithiwat) ([brickstechnology/prest](https://github.com/brickstechnology/prest)) |

See [v2.5.2 release notes](https://docs.prestd.com/releases/v2.5.2.md) and [Changes since v2.5.1](https://docs.prestd.com/releases/main-since-v2.5.1.md). **Upgrade from v2.5.1 or earlier now**, and audit `prest_queries` if you used database-backed queries without auth.

## v2.5.1 highlights

| Area     | Change                                                                                     |
| -------- | ------------------------------------------------------------------------------------------ |
| MCP      | Read-only `/_mcp` on the MySQL adapter ([#1056](https://github.com/prest/prest/pull/1056)) |
| Registry | A `[[databases]]` alias serves only its own database as `{schema}`                         |
| JSON     | Integers above 2^53 are written exactly; large MySQL integers scan as JSON numbers         |
| Errors   | Connection failure is **503** `database unavailable` with no driver text                   |
| Images   | Docker tags are linux/amd64 and linux/arm64                                                |

See [v2.5.1 release notes](https://docs.prestd.com/releases/v2.5.1.md) and [MySQL](https://docs.prestd.com/databases/mysql.md).

## v2.5.0 highlights

| Area         | Change                                                                                                                                                                        |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| MySQL        | Native dialect adapter for MySQL 8.0.19+ when `engine = "mysql"` ([#1048](https://github.com/prest/prest/pull/1048))                                                          |
| JOIN ACL     | Restricted joins return only permitted columns; bad joins are rejected ([#1032](https://github.com/prest/prest/pull/1032), [#1033](https://github.com/prest/prest/pull/1033)) |
| Plugins      | Middleware `.so` builds share the server module; missing plugins no-op ([#1039](https://github.com/prest/prest/pull/1039))                                                    |
| Dependencies | OpenTelemetry 1.47, Studio table library 8 → 9 ([#1055](https://github.com/prest/prest/pull/1055))                                                                            |

See [v2.5.0 release notes](https://docs.prestd.com/releases/v2.5.0.md) and [MySQL](https://docs.prestd.com/databases/mysql.md). MariaDB is not supported.

## v2.4.2 highlights

| Area           | Change                                                                                                                                                |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| JWT            | HMAC `jwt.key` minimums (32/48/64 bytes); short keys are discarded and **auth disables itself** ([#1017](https://github.com/prest/prest/pull/1017))   |
| JWT            | `jwt.algo` enforced as the sole permitted signature algorithm ([#1017](https://github.com/prest/prest/pull/1017))                                     |
| Custom queries | Bind values with `sqlVal` / `sqlList` / `ident`; rejected interpolated values now fail with `400` ([#1023](https://github.com/prest/prest/pull/1023)) |
| Custom queries | Credential headers withheld from templates; script path traversal rejected ([#1023](https://github.com/prest/prest/pull/1023))                        |
| Logging        | Script SQL no longer logged; CRUD parameter values replaced by a count ([#1023](https://github.com/prest/prest/pull/1023))                            |

See [v2.4.2 release notes](https://docs.prestd.com/releases/v2.4.2.md). **Check `jwt.key` length before upgrading** — a short key leaves the API unauthenticated rather than refusing to start.

## v2.4.1 highlights

| Area           | Change                                                                                                                                                                            |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| MCP            | `/_mcp` honours `[expose]`, closing a catalog-discovery bypass ([#1016](https://github.com/prest/prest/pull/1016))                                                                |
| Custom queries | SQL-keyword screen on interpolated script values ([#1016](https://github.com/prest/prest/pull/1016)) — too broad, relaxed in [v2.4.2](https://docs.prestd.com/releases/v2.4.2.md) |

See [v2.4.1 release notes](https://docs.prestd.com/releases/v2.4.1.md) and [Changes since v2.4.0](https://docs.prestd.com/releases/main-since-v2.4.0.md). Upgrade past v2.4.1 to v2.4.2.

## v2.4.0 highlights

| Area          | Change                                                                                                                    |
| ------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Observability | Opt-in OpenTelemetry traces/metrics/logs, local SigNoz dev stack ([#1003](https://github.com/prest/prest/pull/1003))      |
| Vector search | pgvector KNN ordering (`_korder`) and distance filtering (`:vecdist`) ([#1011](https://github.com/prest/prest/pull/1011)) |
| pREST Studio  | Dependency upgrade — auth-dialog and tool-invocation fixes ([#1004](https://github.com/prest/prest/pull/1004))            |

See [v2.4.0 release notes](https://docs.prestd.com/releases/v2.4.0.md) and [Changes since v2.3.0](https://docs.prestd.com/releases/main-since-v2.3.0.md).

{% hint style="info" %}
`_korder` / `:vecdist` and the `[otel]` section landed in v2.4.0 and are unchanged in v2.4.1 and v2.4.2.
{% endhint %}

## v2.3.0 highlights

| Area           | Change                                                                                                                                                                                                      |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Security       | Unauthenticated `_select` SQL-injection fixed — CVSS 9.8 ([GHSA-qvx3-q8vx-9q3c](https://github.com/prest/prest/security/advisories/GHSA-qvx3-q8vx-9q3c), [#1002](https://github.com/prest/prest/pull/1002)) |
| Multi-adapter  | Adapter registry, automatic Postgres/TimescaleDB detection, path-based routing ([#999](https://github.com/prest/prest/pull/999))                                                                            |
| JWKS hardening | `jwx/v3` — non-2xx rejection, 1 MiB body cap, URL redaction in logs ([#1002](https://github.com/prest/prest/pull/1002))                                                                                     |

See [v2.3.0 release notes](https://docs.prestd.com/releases/v2.3.0.md). Upgrade from v2.2.0 as soon as possible for the security fix.

## v2.2.0 highlights

| Area           | Change                                                                                                                                                         |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| pREST Studio   | Embedded UI at `/_studio/` — Data / REST / MCP explorers ([#990](https://github.com/prest/prest/pull/990))                                                     |
| Custom queries | Optional database storage, registry API, query ACL ([#980](https://github.com/prest/prest/pull/980))                                                           |
| TimescaleDB    | E2E certification on the native PostgreSQL adapter ([#988](https://github.com/prest/prest/pull/988))                                                           |
| Config sample  | Fully documented [`prest.sample.toml`](https://github.com/prest/prest/blob/v2.2.0/samples/prest.sample.toml) ([#978](https://github.com/prest/prest/pull/978)) |

See [v2.2.0 release notes](https://docs.prestd.com/releases/v2.2.0.md), [Changes since v2.1.0](https://docs.prestd.com/releases/main-since-v2.1.0.md), and [pREST Studio](https://docs.prestd.com/get-started/prest-studio.md).

## v2.1.0 highlights

| Area               | Change                                                                                                                                  |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| MCP over HTTP      | Read-only `/_mcp` endpoint with JSON-RPC `initialize`, `tools/list`, and `tools/call` ([#977](https://github.com/prest/prest/pull/977)) |
| Schema-aware tools | Per-table `prest.select.{database}.{schema}.{table}` tools with typed input schemas from catalog metadata                               |
| Safety             | Read-only by design; inherits auth, ACL, and identifier validation from the existing HTTP stack                                         |

See [v2.1.0 release notes](https://docs.prestd.com/releases/v2.1.0.md), the [MCP over HTTP guide](https://docs.prestd.com/get-started/mcp-over-http.md), and [AI and MCP](https://docs.prestd.com/ai.md) (Cursor / Claude Desktop / adapter install) for usage and upgrade notes.

## v2.0.0 highlights

| Area              | Change                                                                                                               |
| ----------------- | -------------------------------------------------------------------------------------------------------------------- |
| Multi-database    | `[[databases]]` registry, alias routing, `/_ready` ([#973](https://github.com/prest/prest/pull/973))                 |
| Config resilience | Graceful fallbacks; startup never blocked by bad config ([#974](https://github.com/prest/prest/pull/974))            |
| JWT               | Auto-disable when misconfigured; `jwt.default` defaults to `false` ([#974](https://github.com/prest/prest/pull/974)) |
| Security          | Template sanitization, credential redaction in logs ([#972](https://github.com/prest/prest/pull/972))                |
| OR filtering      | `_or` query parameter ([#958](https://github.com/prest/prest/pull/958))                                              |
| Permissions       | Per-user table permissions ([#912](https://github.com/prest/prest/pull/912))                                         |

See [v2.0.0 release notes](https://docs.prestd.com/releases/v2.0.0.md) and [Changes since rc6](https://docs.prestd.com/releases/main-since-rc6.md) for full details.

## Release candidate history (rc1 – rc6)

The v2 release candidates shipped the following before v2.0.0 was tagged.

### Features

| Version | Change                                                                                               |
| ------- | ---------------------------------------------------------------------------------------------------- |
| rc1     | Per-user table permissions via `[[access.users]]` ([#912](https://github.com/prest/prest/pull/912))  |
| rc6     | OR clause filtering with the `_or` query parameter ([#958](https://github.com/prest/prest/pull/958)) |
| rc6     | Structured JSON logging via Go `slog` ([#950](https://github.com/prest/prest/pull/950))              |
| rc6     | Docker images built with GoReleaser ([#953](https://github.com/prest/prest/pull/953))                |

### Security

| Version | Change                                                                                                                                                                                                                    |
| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| rc3     | `_returning` parameter hardened against SQL injection ([#935](https://github.com/prest/prest/pull/935))                                                                                                                   |
| rc4     | Unified identifier validation across templates, groupby, and path params ([#938](https://github.com/prest/prest/pull/938), [GHSA-p46v-f2x8-qp98](https://github.com/prest/prest/security/advisories/GHSA-p46v-f2x8-qp98)) |
| rc5     | `tsquery` operator hardened against SQL injection ([#940](https://github.com/prest/prest/pull/940))                                                                                                                       |
| rc6     | JWT auth bypass fixed when default enforcement runs without a key ([#960](https://github.com/prest/prest/pull/960), [GHSA-fj7v-859r-2fm4](https://github.com/prest/prest/security/advisories/GHSA-fj7v-859r-2fm4))        |

### Config and breaking changes

| Version | Change                                                                                                                                                              |
| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| rc2     | Deprecated `PREST_SSL_*` environment variables and `[ssl]` TOML block removed — use `PREST_PG_SSL_*` / `[pg.ssl]` ([#919](https://github.com/prest/prest/pull/919)) |
| rc2     | Default `pg.ssl.mode` is `disable` when no config file is found (v1 used `require`)                                                                                 |
| rc6     | Server refuses to start when JWT is enabled without verification material (unless debug mode is on)                                                                 |

### Fixes

| Version | Change                                                                                                               |
| ------- | -------------------------------------------------------------------------------------------------------------------- |
| rc2     | Default cache storage path set when caching is disabled ([#918](https://github.com/prest/prest/pull/918))            |
| rc6     | `_select` field names are whitespace-trimmed after comma splitting ([#941](https://github.com/prest/prest/pull/941)) |
| rc6     | Identifier formatting fix ([#955](https://github.com/prest/prest/pull/955))                                          |

## Upgrading

If you are moving from v1 to v2, see the [Upgrading to v2](https://docs.prestd.com/get-started/upgrading-to-v2.md) guide.
