Skip to content

Commit ff54c94

Browse files
authored
Product update: OpenAPI 3.2 partial support
1 parent 7a5d6d3 commit ff54c94

File tree

2 files changed

+22
-0
lines changed

2 files changed

+22
-0
lines changed
Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
title: "OpenAPI 3.2: partial support"
3+
tags: [Improvement]
4+
image: /images/changelog/openapi-3-2-partial-support.png
5+
---
6+
7+
![openapi-3-2-partial-support.png](/images/changelog/openapi-3-2-partial-support.png)
8+
9+
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).
10+
11+
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.
12+
13+
We started supporting some of the features brought by this new version:
14+
- The QUERY method is now supported in both the documentation and the API Explorer.
15+
- 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.
16+
- 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.
17+
- `summary` can be added to responses when the level of detail doesn't justify the use of the existing `description` field.
18+
- Security schemes can now be `deprecated`.
19+
20+
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.
21+
22+
As always, you can reach out at [[email protected]](mailto:[email protected]) for any questions/feedback.
197 KB
Loading

0 commit comments

Comments
 (0)