From a0fdf03be04dc96ce542161055028e41479f6e86 Mon Sep 17 00:00:00 2001 From: Florian Sylvain Date: Fri, 23 Oct 2026 01:57:29 +0200 Subject: [PATCH] docs: release notes for v3.5.3-beta --- docs/release-notes.md | 1 + docs/releases/v3.5.3-beta.md | 13 +++++++++++++ 2 files changed, 14 insertions(+) create mode 100644 docs/releases/v3.5.3-beta.md diff --git a/docs/release-notes.md b/docs/release-notes.md index 94c0e00..d9ca74b 100644 --- a/docs/release-notes.md +++ b/docs/release-notes.md @@ -46,3 +46,4 @@ Each body lives in `docs/releases/.md`. Publish with `tea releases create - | `v3.5.0-beta` | Relation field | | `v3.5.1-beta` | Relation picker fix | | `v3.5.2-beta` | LLM documentation and MCP server | +| `v3.5.3-beta` | OpenAPI response schemas | diff --git a/docs/releases/v3.5.3-beta.md b/docs/releases/v3.5.3-beta.md new file mode 100644 index 0000000..4fb7c58 --- /dev/null +++ b/docs/releases/v3.5.3-beta.md @@ -0,0 +1,13 @@ +This release fixes the OpenAPI description served at `/openapi.json`, whose response schemas were empty. + +## Improvements and fixes + +- Every successful response in `/openapi.json` now has a schema (object properties, required keys, array items and scalar types) instead of an empty one, so client generators produce typed models. The schemas are inferred from the sample responses of the API reference. + +## Upgrading + +- Replace the binary, or pull the new image. No schema migration and no new environment variable. + +## Known limitations + +- Because the schemas come from sample responses, a field that is `null` in a sample is typed `null`, a field missing from a sample is missing from its schema, and timestamps are plain strings.