Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions src/_product-updates/2025-12-22-openapi-3-2-partial-support.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
title: "OpenAPI 3.2: partial support"
tags: [Improvement]
image: /images/changelog/openapi-3-2-partial-support.png
---

![openapi-3-2-partial-support.png](/images/changelog/openapi-3-2-partial-support.png)

The OpenAPI Initiative released a new version of their OpenAPI specification in September: [OpenAPI 3.2](https://spec.openapis.org/oas/v3.2.0.html).

If you didn't hear about this new version, feel free to read our [OpenAPI complete guide](/guides/openapi/specification/v3.2/introduction/what-is-openapi/), updated for OpenAPI 3.2.

We started supporting some of the features brought by this new version:
- The QUERY method is now supported in both the documentation and the API Explorer.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it intentional to not mention other operations described via additionalOperations ? (I know I need to test the last PR of the lib curl_generator to verify support on Explorer too)

Copy link
Contributor Author

@grossyoan grossyoan Dec 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are you talking about specific methods, or any verbs?

If it's about being able to add any verbs, I'll update only the help center page once it's fully verified 🙏

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

that's indeed about specific methods or verbs, that we support, except on the explorer side (where I didn't time yet to verify the fix on curl-generator lib).

- Servers can now have a `name`, which can be combined with the existing `description` field to provide users with a clear context about a server's usage.
- Tags now offers a `summary` property. Behaving like our existing x-displayName vendor extension, it gives a way to display a group name in the documentation that is different from the tag name.
- `summary` can be added to responses when the level of detail doesn't justify the use of the existing `description` field.
- Security schemes can now be `deprecated`.

OpenAPI 3.2 definition files can be deployed through your usual deployment process: using our [Github Action](https://github.com/bump-sh/github-action), our [CLI](https://github.com/bump-sh/cli), our [API](https://developers.bump.sh/) (now in OpenAPI 3.2 ✨), or directly in your Bump.sh dashboard.

As always, you can reach out at [[email protected]](mailto:[email protected]) for any questions/feedback.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.