The api contract everyone codes against just got a new version. openapi specification 3.2.0 shipped…
the api contract everyone codes against just got a new version. openapi specification 3.2.0 shipped september 10, tightening runtime expression grammar and source description resolution.
the boring spec is where all the real api work now happens.
Context
The standard is the OpenAPI Specification. Version 3.2.0 was published on September 19, 2025, and its release notes list ABNF for path templating, server variables and runtime expressions in the Link Object. The specification site shows Version 3.2.1 dated September 10, 2026, a patch release, with an appendix on parsing and resolution guidance. A tracker issue for the 3.2.1 release lists schema fixes, for example that propertyName is required in the discriminator object.
The note says 3.2.0 shipped September 10. September 10, 2026 is 3.2.1, and 3.2.0 was a year earlier. Which specific changes went into 3.2.1 was not confirmed, as no 3.2.1 changelog was read and the tracker issue was open as of early August 2026. The note's two named items, runtime expression grammar and source description resolution, are plausible for the 3.2.x line, but the mapping to 3.2.1 is unresolved, so it is not over-specified here. Everyone codes against it is the author's framing.
Watch next
- The 3.2.1 release notes and tag on the repository.
Sources
- OpenAPI Specification 3.2.0 release (September 19, 2025)github.com
- OpenAPI Specification 3.2.1 (September 10, 2026)spec.openapis.org
- OpenAPI tracker: v3.2.1 releasegithub.com
Provenance
The note above is reproduced unedited from the original post, first published on Threads on 22 September 2026 at 04:19 IST. Sources are the papers and datasets the note draws on.
View the original post ↗Embed this note
More notes
The air is now being asked to keep its own ledger
the air is now being asked to keep its own ledger: ecmwf’s aifs compo becomes the first ai model to forecast atmospheric composition globally every three hours, cleanair simulates 365 days of pm2.5 over china in ten seconds, and a unified framework maps six pollutants at one kilometer across the whole country. the air now files its own composition report.
read the note →The current is now being asked to draw its own map
the current is now being asked to draw its own map: china’s langya 2.0 predicts six ocean phenomena including internal waves and mesoscale eddies, a deep net called wenhai resolves eddies globally with air sea flux formulas built in, and scripps infers surface currents from the way temperature patterns deform in satellite images. the ocean now files its own circulation report.
read the note →The soil is now being asked to report its own carbon
the soil is now being asked to report its own carbon: a nix color sensor paired with generative data augmentation predicts soil organic carbon without a lab, random forest drives 74 percent of soil health mapping studies, and sentinel 2 tracks five year carbon change across france and italy from 922 samples. the dirt now files its own carbon account.
read the note →