From The Blog

Tag Kinds in OpenAPI 3.2

Title image for tag kinds in OpenAPI 3.2
OpenAPI tags have always been annoying: user-supplied arbitrary data for endpoints should be a fabulous feature – but the documentation tools seem to think that tags are only for them so it becomes more difficult to use tags for other purposes. In fact it is very useful to be able to tag endpoints with lots of different categories of data and so in OpenAPI 3.2, tags were enhanced to include an additional “kind” field so that different kinds of tag could be used. Continue reading

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

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