From The Blog

Nested tags in OpenAPI 3.2

Title image for Nested Tags in OpenAPI 3.2
OpenAPI has always had support for simple tags, but the OpenAPI 3.2 release brought in some serious tag upgrades including a summary field, a “kind” field with registry, – and the ability to nest tags which is the focus of today’s post. If one level of organisation isn’t enough for your API (and on bigger APIs I’d argue it shouldn’t be) then the ability to indicate which tag is the parent of this tag will be a good feature to adopt when you upgrade your OpenAPI descriptions. Continue reading

Notification Contexts Matter

Like many of you, my days are dominated by notifications. Emails from project management systems, source control systems, calendar invitations, ticket updates, and message about messages on other platforms. I’ve noticed that some people use notifications as a power tool, while others seem blind to what happens when they do something. So this post is some tips that I’ve picked up along the way. Continue reading

Quick local API docs with Scalar

Today I’m sharing a quick-and-dirty script to take an OpenAPI description, spin up a docs server locally, and copy the URL into your clipboard. I also use a bit of glob expansion in my script to find the right folder, because I have a lot of APIs with long and formulaic directory names (TM Forum members know this story). I’m spinning up Scalar here as it’s my current favourite just-works local API docs platform. Continue reading

Talks, Articles, Podcasts, and More

Slides

What’s new in OpenAPI 3.2


APIDays London, September 2025
Article

OpenAPI: How to handle file management


The New Stack, April 2025
Slides

OpenAPI for Web Developers


PHP UK Conference, February 2025
Article

New OpenAPI Standards


The New Stack, February 2025
Video

Panel: Maintaining Open Source Software


State of Open, February 2025
Slides

OpenAPI Standards Landscape


FOSDEM, February 2025